Advanced Analytica Advanced Analytica: IBOM
← All connectors
Calendly logo

Source connector

Calendly

Set up Calendly as a source and move its data into your chosen destination.

Version 1.1.0 community alpha

Calendly

Sync data from Calendly API v2, including organization members, groups, teams, invitations, event types and hosts. You can also sync availability schedules, meeting locations, webhook subscriptions, scheduled events, event invitees, routing forms and submissions. Other supported data includes contacts, outgoing communications, activity logs and meeting recaps.

Prerequisites

  • A Calendly account. API access is available on all Calendly plans, including Free. Routing forms and submissions need Teams. Outgoing communications and activity logs need Enterprise. Meeting recaps need a plan with Notetaker. Calendly can deny contacts with a paid-plan error. See Plan-gated streams.
  • An organization owner or administrator account. This account must read organization-wide data, including scheduled events, webhook subscriptions, activity logs and outgoing communications. The connector reads the current organization from the authenticated user’s profile. You don’t need to enter an organization ID.
  • One of these credentials:
    • OAuth: In Airbyte Cloud, sign in to Calendly during setup. In Airbyte Open Source, OAuth needs your Calendly OAuth application’s client ID and client secret.
    • A personal access token with the read scopes for every stream you sync, as listed in Token scopes.
  • A start date in UTC. The connector reads scheduled events starting on or after this date. It reads outgoing communications, activity log entries and meeting recaps from this time onwards.

Set up Calendly

Use OAuth

  1. Create a Calendly source in Airbyte and select OAuth under Authentication.
  2. Select Authenticate your Calendly account and sign in to Calendly as an organization owner or administrator.
  3. Review and allow the requested access. Calendly grants the read scopes configured on Airbyte’s Calendly OAuth application. You don’t select the scopes yourself.
  4. Enter a Start date (UTC) and, optionally, a Lookback window (days) as described below.

Calendly rotates the OAuth refresh token whenever Airbyte requests a new access token. Airbyte stores the new token automatically. If Calendly rejects the refresh token, re-authenticate in the source settings. This can happen after you revoke Airbyte’s access in Calendly.

Each refresh spends the previous refresh token, so use one connection for each OAuth source. If two connections refresh the same source simultaneously, one will ask you to re-authenticate. Use a personal access token when several connections read the same Calendly account.

Use a personal access token

In Airbyte Open Source, use a personal access token unless you’ve registered your own Calendly OAuth application.

  1. In Calendly, open the Profile menu, select Developer, then select Personal access tokens. If Developer isn’t in your Profile menu, manage tokens from the Integrations page instead.
  2. Select Create personal access token, enter a token name, then select Next.
  3. Select the read scopes listed in Token scopes, then select Create.
  4. Enter the verification code Calendly emails you, then copy the token. Calendly displays the token only once.
  5. In Airbyte, create a Calendly source and select Personal access token under Authentication. Enter the token in Calendly personal access token. Enter a Start date (UTC) and, optionally, a Lookback window (days) as described below.

The connection check reads only the authenticated user’s profile (api_user). A successful check confirms users:read access, but not every stream’s required permissions. Missing stream-specific scopes or organization permissions can still cause a sync to fail.

Configuration

InputTypeDescriptionDefault Value
credentials.auth_typestringRequired. oauth2.0 for OAuth, or api_key for a personal access token.
credentials.client_idstringRequired for OAuth. Client ID of the Calendly OAuth application. Airbyte Cloud fills it in when you authenticate.
credentials.client_secretstringRequired for OAuth. Client secret of the Calendly OAuth application. Airbyte Cloud fills it in when you authenticate.
credentials.refresh_tokenstringRequired for OAuth. Refresh token returned by Calendly; the connector replaces it with the rotated token after every refresh.
credentials.api_keystringRequired for a personal access token. The personal access token created during setup. Configurations from versions before 1.1.0 that set a top-level api_key are moved here automatically.
start_datestringRequired. Read scheduled events starting on or after this time, and outgoing communications, activity log entries and meeting recaps from this time on. Use UTC in the format YYYY-MM-DDTHH:mm:ssZ, for example 2024-01-01T00:00:00Z. It applies to event start times, not to when invitees booked.
lookback_daysnumberOptional. Incremental scheduled_events syncs re-emit events whose updated_at falls within this many days before the last synced update, plus a fixed five minutes. Every sync pages through all events from the start date, so 0 is right for most connections.0

When creating or updating the source through the Airbyte API or Terraform, put the personal access token inside credentials. For example, use {"auth_type": "api_key", "api_key": "<token>"}. The request no longer reads a top-level api_key. Sources saved before 1.1.0 move the token into credentials during their next check, schema refresh or sync. If you edit one in the Airbyte UI before then, enter the token again.

Token scopes

With OAuth, Calendly grants the scopes configured on Airbyte’s Calendly OAuth application. These scopes cover every stream below. The rest of this section applies to personal access tokens.

Since March 2026, new Calendly tokens have no API access until you select their scopes. Tokens created earlier keep their access. Select the scopes for every stream you sync. Every token also needs users:read for the connection check. If a scope is missing, the sync error identifies it. Version 0.3.0 added user_availability_schedules, locations and webhook_subscriptions. These streams need availability:read, locations:read and webhooks:read. Version 0.4.0 added routing_forms, routing_form_submissions, contacts, outgoing_communications, activity_log_entries and meeting_recaps. These streams need routing_forms:read, contacts:read, outgoing_communications:read, activity_log:read and meeting_recaps:read. Calendly sets a token’s scopes when you create it. Create a token with these scopes before syncing these streams, then update it in the source settings. Connections that propagate all field and stream changes add these streams automatically.

StreamRequired scopes
api_userusers:read
event_typesusers:read, event_types:read
groupsusers:read, groups:read
organization_membershipsusers:read, organizations:read
scheduled_eventsusers:read, scheduled_events:read
event_inviteesusers:read, scheduled_events:read
teamsusers:read, organizations:read
event_type_membershipsusers:read, event_types:read
group_relationshipsusers:read, groups:read
user_availability_schedulesusers:read, organizations:read, availability:read
locationsusers:read, organizations:read, locations:read
organization_invitationsusers:read, organizations:read
webhook_subscriptionsusers:read, webhooks:read
routing_formsusers:read, routing_forms:read
routing_form_submissionsusers:read, routing_forms:read
contactscontacts:read
outgoing_communicationsusers:read, outgoing_communications:read
activity_log_entriesusers:read, activity_log:read
meeting_recapsmeeting_recaps:read

Supported sync modes

You can use these sync modes with the Calendly source:

  • Full refresh | Overwrite
  • Full refresh | Append
  • Incremental | Append
  • Incremental | Append + Deduped

Incremental modes apply only to streams marked incremental in Supported streams. Other streams use Full refresh. locations and outgoing_communications have no primary key, so deduplicated modes don’t apply. See Incremental sync behavior for details about incremental syncs for scheduled_events and event_invitees, including how lookback_days applies.

Supported streams

StreamDataPrimary keyFull refreshIncremental
event_typesEvent types in the organization, such as meeting names, durations, and scheduling URLsuriYesYes, using updated_at
api_userThe token owner’s profile and current organizationuriYesNo
groupsGroups in the organizationuriYesNo
organization_membershipsOrganization members, their roles, and user profilesuriYesNo
scheduled_eventsScheduled meetings, including their times, status, and locationuriYesYes, using updated_at
event_inviteesInvitees for each scheduled event, including answers, tracking data, and cancellation informationuriYesYes, dependent on scheduled_events
teamsTeams in the organizationuriYesNo
event_type_membershipsHosts assigned to each event typeuriYesNo
group_relationshipsMember and admin relationships between groups and organization members or inviteesuriYesNo
user_availability_schedulesEach organization member’s availability schedules, including time zones, weekly rules, and date-specific overridesuriYesNo
locationsMeeting location types available to each organization memberNoneYesNo
organization_invitationsInvitations sent to join the organizationuriYesNo
webhook_subscriptionsConfiguration of organization-scoped webhook subscriptions, including callback URLs, subscribed event types, and stateuriYesNo
routing_formsRouting forms in the organization and their questionsuriYesNo
routing_form_submissionsSubmissions of each routing form, including answers, tracking data and the routing resulturiYesNo
contactsContacts the token’s user can accessuriYesNo
outgoing_communicationsEmail and SMS messages Calendly sent for the organizationNoneYesYes, using created_at
activity_log_entriesAudit log of actions in the organizationuriYesYes, using occurred_at
meeting_recapsNotetaker recaps of meetings the token’s user can accessuriYesYes, using the meeting start_time

The connector reads event_invitees for each new or changed event in scheduled_events. It reads every invitee for those events. Each invitee record includes scheduled_event_id, letting you join it to the id in scheduled_events. The invitee stream’s state follows scheduled_events. routing_form_submissions reads submissions from every routing form returned for the organization.

group_relationships reads the relationships for each group returned by groups. Organizations without groups sync this stream without records. The connector skips a group deleted during the sync. Permission errors still fail the sync.

Calendly’s OpenAPI specification marks calendar_event on scheduled_events as deprecated. The value can be null.

The incremental outgoing_communications, activity_log_entries and meeting_recaps streams request a window ending at the sync time. Their cursors never move beyond that time, and they don’t use lookback_days. Calendly returns a meeting recap only after processing finishes. Each sync rereads recaps for meetings starting up to three days before the saved cursor. Recaps that appear or change later need a Full refresh.

Calendly doesn’t return a unique identifier for outgoing communications. This stream therefore has no source-defined primary key, and no field combination is guaranteed unique. A primary key you select can merge distinct messages. Use Full refresh | Overwrite or Incremental | Append for this stream.

user_availability_schedules and locations send one request for each organization member. event_type_memberships sends one request for each event type. These streams aren’t suggested by default. locations has no primary key because Calendly doesn’t return a location identifier. Calendly can also list a location kind more than once. webhook_subscriptions lists only organization-scoped subscriptions. User-scoped and group-scoped subscriptions aren’t synced.

The scheduling-setup streams read configuration, not live availability or webhook deliveries:

  • user_availability_schedules returns availability rules, not bookable time slots or calendar busy times.
  • locations lists the meeting location types configured for each member, not booked meeting locations. Read scheduled_events for meeting-specific locations.
  • webhook_subscriptions lists existing subscriptions. It doesn’t create subscriptions or receive webhook event payloads. Read scheduled_events and event_invitees for bookings and cancellations.

Incremental syncs

Each incremental sync requests scheduled_events from the configured start date. It emits events whose updated_at changed since the previous sync, including upcoming events, cancellations and reschedules. Each sync therefore pages through every event from the start date. It makes as many scheduled_events requests as a Full refresh. On the Free plan, large histories need a later start date or less frequent syncs. lookback_days also re-emits events whose updated_at falls within that many days before the last synced update. It then reads their invitees again. Every sync already pages through all events from the start date, so 0 suits most connections. In every sync mode, events updated after a sync starts are excluded from that sync, along with their invitees. The next sync emits the event if it reads it before another change. With Full refresh | Overwrite, its rows remain missing from the destination until then.

event_invitees follows the scheduled_events state and rereads every invitee for each new or changed event. Calendly doesn’t document which invitee changes update the event’s updated_at. Examples include a no-show or one invitee leaving a group event. If the event remains unchanged, the invitee change reaches the destination after the event’s next change. A Full refresh of event_invitees also captures it.

Your first sync after upgrading to 1.0.0 ignores state saved by earlier versions. It rereads every event from your start date and all its invitees. In Incremental | Append mode, this adds another copy of each event and invitee. See the 1.0.0 migration guide.

Limits and troubleshooting

Plan-gated streams

Routing forms and submissions require Teams. Outgoing communications and activity logs require an Enterprise subscription. Meeting recaps require a paid plan with Notetaker enabled. Calendly also documents a paid-plan error for contacts. If Calendly reports an unavailable plan or feature, these streams finish without records. The connector logs a message explaining the requirement. Missing read scopes, owner or administrator permission errors, and other forbidden responses still fail the sync.

Calendly documents activity log entries and outgoing communications as Enterprise endpoints.

Rate limits

Calendly limits API requests to 500 requests per user each minute on paid plans and 50 on the Free plan. Other applications using the same Calendly user share this allowance.

The connector monitors X-RateLimit-Remaining and waits when the allowance runs out. If Calendly returns HTTP 429, the connector retries after the delay in X-RateLimit-Reset. Invitees and routing form submissions need requests for each scheduled event and form. Large histories can therefore take longer to sync.

Troubleshooting

SymptomAction
HTTP 401: invalid or revoked tokenWith OAuth, re-authenticate in the Airbyte source settings. With a personal access token, create a new token and update the Airbyte source settings.
Calendly rejected the OAuth refresh tokenThe refresh token expired, was revoked or was already used. Re-authenticate in the Airbyte source settings.
HTTP 403: insufficient scope or permission deniedCheck the error for missing scopes. With a personal access token, create a token with the required read scopes. Authenticate with an organization owner or administrator account for organization-wide data such as scheduled events, webhook subscriptions, activity logs and outgoing communications. Update the credentials in Airbyte.
A plan-gated stream syncs no recordsCalendly reported that the plan or feature is unavailable; the sync log names the requirement. Routing forms require Teams; without access to forms, routing form submissions also complete empty.
A scheduled event, event type, member, group or routing form disappears during a syncThe connector logs and skips that event’s invitees, that event type’s hosts, that member’s availability schedules and locations, that group’s relationships, or that form’s submissions, then continues. A 404 on other endpoints fails the sync.
New bookings or cancellations are missingUpgrade to 1.0.0; its first sync reads every event from your start date again. See the 1.0.0 migration guide. Confirm that the connection’s start date covers the event.

IP allow list

If you use Airbyte Cloud and your organization restricts access by IP address, add the Airbyte Cloud IP addresses to your allow list.

Changelog

Version 1.0.0 is a breaking change. Before you upgrade from 0.x, read the 1.0.0 migration guide.

Expand to review
VersionDatePull RequestSubject
1.1.02026-11-1291296Add OAuth authentication as the default; personal access tokens remain available and existing configurations keep working
1.0.02026-11-1190864Fix incremental syncs missing new bookings and cancellations by using updated_at as the scheduled_events cursor, and declare date-time and integer types on existing fields
0.4.22026-11-1091376Update dependencies
0.4.12026-11-0991293Fix syncs that failed on routing_forms and routing_form_submissions below the Calendly Teams plan, and on group_relationships in organizations without groups
0.4.02026-11-0490848Add routing forms and submissions, contacts, outgoing communications, activity logs and meeting recaps streams; they need the new routing_forms:read, contacts:read, outgoing_communications:read, activity_log:read and meeting_recaps:read scopes
0.3.02026-11-0490847Add teams, event type memberships, group relationships, user availability schedules, locations, organization invitations and webhook subscriptions streams; user availability schedules, locations and webhook subscriptions need the new availability:read, locations:read and webhooks:read scopes
0.2.02026-11-0390829Handle rate limits and token errors, declare missing fields, fix the crash when lookback_days is unset, stop dropping event types updated before 2021 and invitees booked before the start date (refresh these streams to backfill)
0.1.582026-11-0390473Update dependencies
0.1.572026-10-2789813Update dependencies
0.1.562026-10-2089122Update dependencies
0.1.552026-10-1388545Update dependencies
0.1.542026-10-0687778Update dependencies
0.1.532026-09-2987092Update dependencies
0.1.522026-09-2286548Update dependencies
0.1.512026-09-1585958Update dependencies
0.1.502026-09-0885409Update dependencies
0.1.492026-08-1884504Update dependencies
0.1.482026-08-1183834Update dependencies
0.1.472026-08-0483371Update dependencies
0.1.462026-07-2882826Update dependencies
0.1.452026-07-2182322Update dependencies
0.1.442026-07-1481752Update dependencies
0.1.432026-06-3080989Update dependencies
0.1.422026-06-2380355Update dependencies
0.1.412026-06-1679778Update dependencies
0.1.402026-06-0979236Update dependencies
0.1.392026-06-0278555Update dependencies
0.1.382026-04-2877167Update dependencies
0.1.372026-04-2176522Update dependencies
0.1.362026-03-3175659Update dependencies
0.1.352026-03-1774912Update dependencies
0.1.342026-03-1074632Update dependencies
0.1.332026-03-0373791Update dependencies
0.1.322026-02-0372615Update dependencies
0.1.312026-01-2072052Update dependencies
0.1.302026-01-1471456Update dependencies
0.1.292025-12-1870622Update dependencies
0.1.282025-11-2569971Update dependencies
0.1.272025-11-1869431Update dependencies
0.1.262025-10-2968715Update dependencies
0.1.252025-10-2168240Update dependencies
0.1.242025-10-1467837Update dependencies
0.1.232025-10-0767205Update dependencies
0.1.222025-09-3066320Update dependencies
0.1.212025-08-0964664Update dependencies
0.1.202025-08-0264409Update dependencies
0.1.192025-07-2663801Update dependencies
0.1.182025-07-1963484Update dependencies
0.1.172025-07-1263040Update dependencies
0.1.162025-06-2862148Update dependencies
0.1.152025-06-2161888Update dependencies
0.1.142025-05-2860946update scheduled events to ingest future events
0.1.132025-05-2460689Update dependencies
0.1.122025-05-1059878Update dependencies
0.1.112025-05-0359314Update dependencies
0.1.102025-04-2658702Update dependencies
0.1.92025-04-1958247Update dependencies
0.1.82025-04-1257661Update dependencies
0.1.72025-04-0557123Update dependencies
0.1.62025-03-2956618Update dependencies
0.1.52025-03-2256087Update dependencies
0.1.42025-03-0855375Update dependencies
0.1.32025-03-0154839Update dependencies
0.1.22025-02-2254274Update dependencies
0.1.12025-02-1551240Update dependencies
0.1.02025-02-1252566Add stream organization members, groups, available event types, and scheduled events.
0.0.82024-12-2850462Update dependencies
0.0.72024-12-2150152Update dependencies
0.0.62024-12-1449551Update dependencies
0.0.52024-12-1249275Update dependencies
0.0.42024-12-1149022Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64
0.0.32024-11-0448279Update dependencies
0.0.22024-10-2847568Update dependencies
0.0.12024-09-01Initial release by @natikgadzhi via Connector Builder
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.