List calendars

Lists the calendars on the connected account, read live from the provider.

GEThttps://api.bentocal.com/au/v1/connections/{connection_id}/calendars

Authentication

AuthorizationstringheaderBearer <token>required

An API key: bc_{live|test}_{region}_…, from the console.

1 param

idstringrequired
The provider's calendar id. Use it in calendar_ids and event writes.
namestringrequired
primarybooleanrequired
True for the account's primary calendar.
can_writebooleanrequired
True when events can be written to this calendar.
time_zonestring | nullrequired
IANA time zone of the calendar, when the provider reports one.

Errors

curl -X GET "https://api.bentocal.com/au/v1/connections/<connection_id>/calendars" \
  -H "Authorization: Bearer YOUR_TOKEN"

[
  {
    "id": "sam@example.com",
    "name": "Sam Lee",
    "primary": true,
    "can_write": true,
    "time_zone": "Australia/Sydney"
  }
]