Appearance
Event Announcement Template
Promote webinars, conferences, product launches, and events.
Template ID
template: "event"Preview
Event-focused layout featuring:
- Event title/name
- Date and time
- Location (virtual or physical)
- Speaker information
- Brand styling
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | Yes | Event name/title |
date | string | No | Event date (e.g., "March 15, 2024") |
time | string | No | Event time (e.g., "9:00 AM PST") |
location | string | No | Venue or "Virtual Event" |
speaker_name | string | No | Featured speaker name |
speaker_avatar_url | string | No | Speaker photo URL |
theme | string | No | dark (default) or light |
logo_url | string | No | Event/company logo |
Example Request
bash
curl -X POST https://ogimageapi.io/api/generate \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{
"title": "DevConf 2024",
"subtitle": "The Future of AI Development",
"date": "March 15, 2024",
"time": "9:00 AM - 5:00 PM PST",
"location": "San Francisco, CA",
"speaker_name": "Dr. Sarah Chen",
"speaker_avatar_url": "https://example.com/sarah.jpg",
"template": "event",
"theme": "dark"
}' \
--output event-og.pngLayout Structure
┌─────────────────────────────────────────┐
│ [Logo] │
│ │
│ DevConf 2024 │
│ The Future of AI Development │
│ │
│ 📅 March 15, 2024 │
│ 🕐 9:00 AM - 5:00 PM PST │
│ 📍 San Francisco, CA │
│ │
│ ┌──────┐ │
│ │Avatar│ Featuring: Dr. Sarah Chen │
│ └──────┘ │
│ │
└─────────────────────────────────────────┘Theme Variations
Dark Theme
- Bold, exciting look
- Great for tech events
- High energy feel
Light Theme
- Professional, clean
- Corporate events
- Formal conferences
Use Cases
| Event Type | Recommended Setup |
|---|---|
| Tech conferences | Dark theme |
| Webinars | Dark theme + speaker |
| Product launches | Dark theme |
| Corporate seminars | Light theme |
| Community meetups | Either theme |
Best Practices
- Include date AND time — Timezone is crucial
- Add speakers for webinars — Builds credibility
- Be specific about location — City, venue, or "Virtual"
- Use clear event titles — Avoid jargon
Integration Examples
Event Platform Integration
javascript
async function generateEventOG(event) {
const response = await fetch('https://ogimageapi.io/api/generate', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': process.env.OG_IMAGE_API_KEY
},
body: JSON.stringify({
title: event.name,
subtitle: event.tagline,
date: formatDate(event.start_date),
time: formatTimeRange(event.start_time, event.end_time, event.timezone),
location: event.is_virtual ? 'Virtual Event' : event.venue,
speaker_name: event.speakers[0]?.name,
speaker_avatar_url: event.speakers[0]?.avatar,
template: 'event',
theme: 'dark',
logo_url: event.organizer.logo
})
});
return response;
}Webinar Registration Pages
javascript
// Generate OG image when webinar is created
async function onWebinarCreated(webinar) {
const ogImage = await generateEventOG({
name: webinar.title,
tagline: webinar.description,
start_date: webinar.scheduled_at,
start_time: webinar.scheduled_at,
end_time: addMinutes(webinar.scheduled_at, webinar.duration),
timezone: webinar.timezone,
is_virtual: true,
speakers: webinar.hosts
});
// Save and attach to webinar...
}Date/Time Formatting
| Input | Recommended Format |
|---|---|
| 2024-03-15 | "March 15, 2024" |
| 09:00 | "9:00 AM" |
| 14:00-17:00 | "2:00 PM - 5:00 PM" |
| Timezone | Always include (PST, EST, UTC) |
Related Templates
- Social Share — Event promotion
- Stats Card — Event metrics (RSVPs, etc.)