Calendly
Read scheduling data, find available times, book invitees, and cancel events
Connect Calendly when a project needs live scheduling data or an app needs to book meetings. A shared connection uses one authorized Calendly account for a project. A published app can instead let each signed-in app user authorize their own Calendly account.
Before you connect
A Swarmz administrator must configure and enable the Calendly OAuth application before the connector appears. Each user still signs in to Calendly and approves access through that application.
In the Calendly developer portal, create an OAuth application and register the callback URL shown on the Swarmz admin integration card. Swarmz uses PKCE and requests read access to users, event types, and scheduled events. Add scheduled-event write access only for booking and cancellation.
Available operations
| Operation | What it does | Limit per minute |
|---|---|---|
list_event_types | Lists event types for a user or organization | 30 |
list_available_times | Lists open times for one event type within a maximum 31-day range | 30 |
list_scheduled_events | Lists active or cancelled events | 30 |
list_invitees | Lists invitees for one scheduled event | 30 |
book_event | Books an invitee into an available time | 10 |
cancel_event | Cancels one scheduled event | 10 |
Booking needs an ISO timestamp, the invitee's name and email, and an IANA timezone such as Europe/Zurich. Write operations require AI approval before Swarmz sends them.
Connect Calendly
Ask for the scheduling workflow and name the connection mode. For a team booking page, say: “Use our shared Calendly connection to show the next available onboarding calls and book the selected time.” For a multi-tenant app, say: “Let each signed-in user connect Calendly and show their upcoming meetings.”
Select Connect new, choose read access, add write access only when booking or cancellation is required, then approve access in Calendly. See Connector connection modes for the shared and app-user difference.
Verify Calendly
- List event types and confirm a known event name.
- Request available times for a range shorter than 31 days.
- Book a disposable test meeting with a test address and confirm it in Calendly.
- Cancel the test event and confirm the cancellation reason.
- Revoke Swarmz in Calendly, repeat a read, and confirm Swarmz asks for reconnection.
Calendly rotates refresh tokens. Swarmz stores the replacement after every successful refresh; an interrupted or invalid rotation requires reconnection instead of reusing an old token. If booking fails while reads work, reconnect with scheduled-event write access and confirm the selected time is still available.