List the user's bookable event types (the meetings invitees can schedule). (docs)
GET /event_types?user={user_uri}
🟢 low
— no
List scheduled (booked) events for the current user. (docs)
GET /scheduled_events?user={user_uri}
🟢 low
— no
List the invitees (name, email, answers) for a given scheduled event. (docs)
GET /scheduled_events/{uuid}/invitees
🟢 low
— no
What the agent can do
Capability
API call
Risk
Needs approval
Create a single-use booking link for an event type (max_event_count=1). (docs)
POST /scheduling_links
🟢 low
— no
Cancel a scheduled event — affects a customer's existing booking. (docs)
POST /scheduled_events/{uuid}/cancellation
🔴 high
✅ yes
Connecting it
You provide: Calendly account (OAuth)
Where to get it: In Calendly: Integrations & apps → API & Webhooks → create an OAuth app (or generate a Personal Access Token for single-account use). Customers connect via the OAuth web-server flow at https://auth.calendly.com/oauth/authorize → exchange the code at https://auth.calendly.com/oauth/token for a Bearer access token. All v2 REST calls target https://api.calendly.com; most list calls require the current user/organization URI from GET /users/me.
Permissions/scopes:none / not scope-based
Account setup
Account needed: A Calendly account. API access (v2) is available on all paid plans; some endpoints/fields are gated to higher tiers.
App registration: OAuth: Integrations & apps → API & Webhooks → create an OAuth app → set the redirect URI → obtain Client ID/Secret. Customers install via the OAuth web-server flow (authorize at auth.calendly.com, token exchange at auth.calendly.com/oauth/token). For single-account use a Personal Access Token works as the Bearer token directly.
Verification required: Calendly reviews OAuth apps before they can be used by accounts outside your own organization; expect an app-review step before going multi-tenant. Personal Access Tokens need no review.
Testing: No sandbox — develop against a real (free trial / paid) Calendly account using a Personal Access Token, then switch to OAuth for production.
Limits
Per-minute rate limits by plan: ~60 requests/minute on Free/Standard/Teams, ~120 requests/minute on Enterprise. HTTP 429 with a Retry-After header on exceed. See https://developer.calendly.com/api-docs/edca8074633f8-rate-limits.