Overview
Calendly is a scheduling platform – event types (templates), scheduled events (booked), and invitees. The Automize Calendly connector covers the read-and-react surface: lookups, cancellations, no-show marking, and webhook subscriptions.
- Regions: Calendly is a single global service – api.calendly.com.
- Plans: Free, Standard, Teams, Enterprise – all expose the API. Some features (multi-org admin, SSO API) need Teams/Enterprise.
Setting up the connection
Auth type: Bearer Token.
- Sign in to Calendly → Integrations → API & Webhooks → Generate New Token.
- Copy the personal access token (long alphanumeric).
- In Automize, open Settings → Connectors → Calendly → Add connection. Paste the token.
- For team-wide automation, use OAuth (not currently exposed) – personal tokens are scoped to one user.
Find your credentials at https://calendly.com/integrations/api_webhooks.
Rate limits
Calendly enforces ~100 requests/min per user. Connector retries 429 with Retry-After.
Data model
Calendly's primitives:
User ─┬─ Event Types (templates: '30min consult')
├─ Scheduled Events (concrete bookings) ─── Invitees
└─ Webhook Subscriptions
All resources use URI-style IDs (https://api.calendly.com/users/<uuid>),
not bare UUIDs.Available operations
13 operations available. Click any row to jump to its detail.
| Operation | Category | What it does |
|---|---|---|
| Cancel Event | General | Cancel a scheduled event |
| Create Webhook | General | Create a webhook subscription |
| Delete webhook | General | Delete a Calendly webhook subscription. |
| Get Event | General | Get scheduled event details |
| Get invitee | General | Get a Calendly invitee by URI. |
| Get Current User | General | Get authenticated user |
| Get organization | General | Get Calendly organization details. |
| List Event Types | General | List available event types |
| List Scheduled Events | General | List scheduled events |
| List Invitees | General | List invitees of an event |
| List organization members | General | List Calendly organization members. |
| List Webhooks | General | List webhook subscriptions |
| Mark no show | General | Mark a Calendly invitee as no-show. |
Operations
Cancel Event
Cancel a scheduled event
| Parameter | Required | Type | Description |
|---|---|---|---|
Event Uuid event_uuid | Yes | text | |
Reason reason | Yes | text |
Tips
- reason is shown to the invitee in cancellation email.
Create Webhook
Create a webhook subscription
| Parameter | Required | Type | Description |
|---|---|---|---|
Url url | Yes | text | |
Events events | Yes | text | |
Organization organization | Yes | text | |
Scope scope | Yes | text |
Delete webhook
Delete a Calendly webhook subscription.
| Parameter | Required | Type | Description |
|---|---|---|---|
Webhook Uuid webhook_uuid | Yes | text |
Get Event
Get scheduled event details
| Parameter | Required | Type | Description |
|---|---|---|---|
Event Uuid event_uuid | Yes | text |
Get invitee
Get a Calendly invitee by URI.
| Parameter | Required | Type | Description |
|---|---|---|---|
Event Uuid event_uuid | Yes | text | |
Invitee Uuid invitee_uuid | Yes | text |
Tips
- Returns invitee + custom question answers + tracking params (utm_source etc.).
Get Current User
Get authenticated user
No input parameters.
Get organization
Get Calendly organization details.
| Parameter | Required | Type | Description |
|---|---|---|---|
Org Uuid org_uuid | Yes | text |
List Event Types
List available event types
No input parameters.
Tips
- user: URI from Get Current User.
- active=true skips deactivated event types.
List Scheduled Events
List scheduled events
No input parameters.
List Invitees
List invitees of an event
| Parameter | Required | Type | Description |
|---|---|---|---|
Event Uuid event_uuid | Yes | text |
Tips
- Per-event invitees. status: active, canceled.
List organization members
List Calendly organization members.
No input parameters.
List Webhooks
List webhook subscriptions
No input parameters.
Mark no show
Mark a Calendly invitee as no-show.
| Parameter | Required | Type | Description |
|---|---|---|---|
Invitee invitee | No | text |
FAQ
- Token vs OAuth – when?
- Personal token is scoped to one user – fine for solo or single-team automation. OAuth is needed if you want to act on behalf of multiple Calendly users in your org (multi-tenant SaaS pattern).
- Why are my URIs failing?
- Calendly uses full URLs as IDs, not UUIDs. Pass 'https://api.calendly.com/users/xxx', not just 'xxx'. Find them via Get Current User → resource.uri fields.
- How do I get the booking custom field answers?
- Get Invitee returns questions_and_answers array. Each item has question (the prompt) and answer (the response).