SapanCalDeveloper Docs

BentoCal API

v1.0.0

BentoCal connects your application to your users' Google and Microsoft calendars: one API for connecting accounts, reading free/busy, finding available times and writing events, plus webhooks when things change.

Send your API key as a bearer token (Authorization: Bearer bc_test_au_…) to your region's base URL, https://api.bentocal.com/{region}/v1. Available regions: au (Australia). Bodies are JSON with snake_case fields, and users are identified by your own ids.

Guides

Base URLhttps://api.bentocal.com/au/v1

Connect sessions

Send a user through connecting a Google or Microsoft account.

POST/connect_sessionsCreate a connect sessionGET/connect_sessions/{connect_session_id}Get a connect session

Users

Your end users and their connections, by your own user id.

GET/users/{user_id}Get a userPATCH/users/{user_id}Update a userDELETE/users/{user_id}Delete a user

Connections

One connected calendar account.

GET/connections/{connection_id}Get a connectionDELETE/connections/{connection_id}Revoke a connectionGET/connections/{connection_id}/calendarsList calendars

Scheduling

Free/busy and available times across users.

POST/free_busyGet free/busyPOST/availabilityFind available times

Events

Write events to a user's calendar under your own event id.

PUT/users/{user_id}/events/{event_id}Create or update an eventDELETE/users/{user_id}/events/{event_id}Delete an event

Webhooks

Events BentoCal sends to your webhook URL.

POSTconnection.createdA user connected a calendar accountPOSTconnection.relinkedA user relinked a connectionPOSTconnection.relink_requiredA connection needs relinking (the provider stopped accepting its grant)POSTconnection.revokedA connection was revokedPOSTcalendar.changedEvents changed on a connection's primary calendar