Skip to content

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

ParameterTypeRequiredDescription
titlestringYesEvent name/title
datestringNoEvent date (e.g., "March 15, 2024")
timestringNoEvent time (e.g., "9:00 AM PST")
locationstringNoVenue or "Virtual Event"
speaker_namestringNoFeatured speaker name
speaker_avatar_urlstringNoSpeaker photo URL
themestringNodark (default) or light
logo_urlstringNoEvent/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.png

Layout 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 TypeRecommended Setup
Tech conferencesDark theme
WebinarsDark theme + speaker
Product launchesDark theme
Corporate seminarsLight theme
Community meetupsEither theme

Best Practices

  1. Include date AND time — Timezone is crucial
  2. Add speakers for webinars — Builds credibility
  3. Be specific about location — City, venue, or "Virtual"
  4. 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

InputRecommended Format
2024-03-15"March 15, 2024"
09:00"9:00 AM"
14:00-17:00"2:00 PM - 5:00 PM"
TimezoneAlways include (PST, EST, UTC)

Generate stunning Open Graph images programmatically.