OverviewAPI ReferenceResources
Calendar

List calendar events

Returns upcoming events from the calendar connected in the Convo desktop app, Google or Outlook, by start time. Events come in the provider's own format. Declined and cancelled events are left out. Without timeMax, Outlook looks 7 days ahead and Google has no end.

GET
/api/v1/calendar/events

Authorization

AuthorizationRequiredBearer <token>

A Convo API key: convo_ followed by 32 hex characters. Create it in the Convo desktop app under Settings → Convo API.

In: header

Query Parameters

maxResultsinteger

Events to return, 1 to 50

Default: 10Minimum: 1Maximum: 50
timeMinstring

Start of the window (ISO 8601). Defaults to now.

Format: "date-time"
timeMaxstring

End of the window (ISO 8601)

Format: "date-time"
curl -X GET "https://www.itsconvo.com/api/v1/calendar/events?maxResults=10&timeMin=2019-08-24T14%3A15%3A22Z&timeMax=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"
        }
      ]
    }
  ]
}

Was this page helpful?

List unresolved threads

Open action items from meetings with your contacts, oldest meeting first, so the ones waiting longest come first. Items you marked resolved or dismissed are left out, and so are meetings not matched to a contact. Requires a Professional or Enterprise plan with Convo Memory enabled. Without Memory, the list is empty and `reason` is `no-brain`.

Get profile and usage

Returns your profile, your plan and how many AI credits you have used this month.