Calendars

All endpoints require authentication. See Authentication for details.

Every request should include these headers:

Authorization: Bearer YOUR_API_TOKEN
Accept: application/json

Calendar access requires an Account with google_calendar_used enabled and connected via the Google OAuth flow in the admin panel. To connect Google Calendar, edit the account in the Filament admin area, enable the Google Calendar toggle, and click Connect Google Account.

Permissions

Each account has two fine-grained permission flags that control calendar access:

• google_calendar_read — must be enabled to use GET endpoints. If disabled, all GET requests return 403 Forbidden.
• google_calendar_write — must be enabled to use POST endpoints. If disabled, all POST requests return 403 Forbidden.

Both flags default to enabled. They can be toggled per-account in the Filament admin UI under the Google Calendar section.

GET /api/{account}/calendar

Returns a paginated list of upcoming calendar entries from the account's primary Google Calendar.

curl -s "https://your-domain.com/api/1/calendar?page=1&per_page=10" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Success Response (200)

{
  "data": [
    {
      "id": "abc123xyz",
      "title": "Team Standup",
      "start": "2026-04-11T09:00:00+00:00",
      "end": "2026-04-11T09:30:00+00:00",
      "location": "Google Meet"
    },
    {
      "id": "def456uvw",
      "title": "Product Review",
      "start": "2026-04-11T14:00:00+00:00",
      "end": "2026-04-11T15:00:00+00:00",
      "location": null
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 3,
    "per_page": 10,
    "total": 25
  }
}

Error Responses

GET /api/{account}/calendar/{eventId}

Returns full details for a single calendar entry.

curl -s https://your-domain.com/api/1/calendar/abc123xyz \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Success Response (200)

{
  "data": {
    "id": "abc123xyz",
    "title": "Team Standup",
    "description": "Daily sync with the engineering team.",
    "start": "2026-04-11T09:00:00+00:00",
    "end": "2026-04-11T09:30:00+00:00",
    "location": "Google Meet",
    "attendees": [
      {
        "email": "alice@example.com",
        "name": "Alice Smith",
        "response_status": "accepted"
      },
      {
        "email": "bob@example.com",
        "name": "Bob Jones",
        "response_status": "needsAction"
      }
    ],
    "html_link": "https://www.google.com/calendar/event?eid=..."
  }
}

Error Responses

POST /api/{account}/calendar

Creates a new event on the account's primary Google Calendar.

curl -s -X POST "https://your-domain.com/api/1/calendar" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "summary": "Team Standup",
    "description": "Daily sync with the engineering team.",
    "location": "Google Meet",
    "start": {
      "dateTime": "2026-04-11T09:00:00+02:00",
      "timeZone": "Africa/Johannesburg"
    },
    "end": {
      "dateTime": "2026-04-11T09:30:00+02:00",
      "timeZone": "Africa/Johannesburg"
    }
  }'

Success Response (201)

{
  "data": {
    "id": "abc123xyz",
    "title": "Team Standup",
    "description": "Daily sync with the engineering team.",
    "start": "2026-04-11T09:00:00+02:00",
    "end": "2026-04-11T09:30:00+02:00",
    "location": "Google Meet",
    "attendees": [],
    "html_link": "https://www.google.com/calendar/event?eid=..."
  }
}

Error Responses