List calendar events

Returns upcoming Google Calendar events. Requires Google Calendar connected in the Convo dashboard.

Authorization

AuthorizationRequiredBearer <token>

API key as Bearer token. Generate keys in your Convo dashboard settings.

In: header

Query Parameters

maxResultsinteger

Default: 10Minimum: 1Maximum: 50

timeMinstring

Filter events starting after this time (ISO 8601)

Format: "date-time"

curl -X GET "https://www.itsconvo.com/api/v1/calendar/events?maxResults=10&timeMin=2019-08-24T14%3A15%3A22Z" \
  -H "Authorization: Bearer <token>"

Calendar events

{
  "data": [
    {
      "id": "evt_abc123",
      "summary": "Weekly Standup",
      "start": {
        "dateTime": "2026-03-19T09:00:00-04:00",
        "timeZone": "America/New_York"
      },
      "end": {
        "dateTime": "2026-03-19T09:30:00-04:00",
        "timeZone": "America/New_York"
      },
      "attendees": [
        {
          "email": "alice@example.com",
          "displayName": "Alice Chen",
          "responseStatus": "accepted"
        },
        {
          "email": "bob@example.com",
          "displayName": "Bob Smith",
          "responseStatus": "accepted"
        }
      ]
    }
  ]
}

List calendar events

Authorization

Query Parameters

Response

TypeScript