Events API

Events include company dates, awareness days, cultural celebrations, and recurring occasions. Each event can have suggested content to help you create relevant newsletter blocks.

List events

GET /api/v1/events

Parameter	Type	Description
upcoming	boolean	Only future events
days_ahead	integer	Events within N days from today
category	string	Filter: awareness_day, cultural, seasonal, corporate, wellness, diversity

# Events in the next 14 days
curl "https://your-app.com/api/v1/events?upcoming=true&days_ahead=14" \\
  -H "Authorization: Bearer inl_your_key"

Get event details

GET /api/v1/events/:slug

Returns the event with its description, suggested content, and any linked content blocks:

{
  "event": {
    "slug": "mental-health-awareness-week",
    "name": "Mental Health Awareness Week",
    "event_date": "2026-05-18",
    "category": "wellness",
    "description": "An annual event to raise awareness...",
    "suggested_content": "Consider sharing mental health resources, employee assistance programme details, and management tips for supporting wellbeing.",
    "content_blocks": [
      {"id": "cb_123", "title": "Wellbeing Resources", "status": "ready"}
    ]
  }
}

Using events with content blocks

When creating a content block, you can link it to an event:

{
  "title": "Mental Health Resources for the Team",
  "body": "...",
  "block_type": "event_announcement",
  "event_slug": "mental-health-awareness-week"
}