Calendar API

Google Calendar integration and event management

Overview

The Calendar API provides endpoints for managing Google Calendar events and scheduling.

Base Path: /api/calendar

Endpoints

List Events

GET /api/calendar/events

Query Parameters:

• start_date: ISO 8601 date (default: today)
• end_date: ISO 8601 date (default: 30 days from now)
• limit: Number of events (default: 100)

Response:

{
  "events": [
    {
      "id": "event-123",
      "summary": "Meeting with Acme Corp",
      "start": "2024-01-25T14:00:00Z",
      "end": "2024-01-25T15:00:00Z",
      "attendees": ["[e-mail]"],
      "location": "Video call"
    }
  ],
  "total": 5
}

Create Event

POST /api/calendar/events

Request Body:

{
  "summary": "Partnership discussion",
  "start": "2024-01-25T14:00:00Z",
  "end": "2024-01-25T15:00:00Z",
  "attendees": ["[e-mail]", "[e-mail]"],
  "description": "Discuss Q1 partnership",
  "company_id": "550e8400-e29b-41d4-a716-446655440000"
}

Response (201 Created):

{
  "id": "event-456",
  "summary": "Partnership discussion",
  "start": "2024-01-25T14:00:00Z",
  "calendar_link": "https://calendar.google.com/event?eid=..."
}

Update Event

PATCH /api/calendar/events/{event_id}

Delete Event

DELETE /api/calendar/events/{event_id}

Frontend Integration

async function createCalendarEvent(event: CalendarEvent) {
  const response = await fetch('/api/calendar/events', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(event)
  })

  return response.json()
}

Next Steps

Calendar Integration

Setup guide

OAuth Setup

Configure OAuth

Interactions API

Track meetings