Skip to main content
GET
/
api
/
v1
/
calendar
/
events
List calendar events
curl --request GET \
  --url https://www.itsconvo.com/api/v1/calendar/events \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "<string>",
      "summary": "Weekly Standup",
      "start": {
        "dateTime": "2023-11-07T05:31:56Z",
        "timeZone": "<string>"
      },
      "end": {
        "dateTime": "2023-11-07T05:31:56Z",
        "timeZone": "<string>"
      },
      "attendees": [
        {
          "email": "<string>",
          "displayName": "<string>",
          "responseStatus": "<string>"
        }
      ]
    }
  ]
}

Authorizations

Authorization
string
header
required

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

Query Parameters

maxResults
integer
default:10
Required range: 1 <= x <= 50
timeMin
string<date-time>

Filter events starting after this time (ISO 8601)

Response

Calendar events

data
object[]