Skip to main content

Calendly

This connector captures data from Calendly into Estuary collections.

This connector is available for use in the Estuary web application. For local development or open-source workflows, ghcr.io/estuary/source-calendly:v1 provides the latest connector image. You can also follow the link in your browser to see past image versions.

Supported data resources

The connector captures the following Calendly resources:

info

Resources that require a Calendly Teams account are automatically omitted during discovery when the authenticated account is not on a Teams plan.

Prerequisites

Configuration

You configure connectors either in the Estuary web app, or by directly editing the catalog specification file. See connectors to learn more about using connectors. The values and specification sample below provide configuration details specific to the Calendly source connector.

Properties

Endpoint

PropertyTitleDescriptionTypeRequired/Default
/credentialsAuthenticationPersonal Access Token credentials for Calendly.objectRequired
/credentials/access_tokenAccess TokenCalendly Personal Access Token.stringRequired
/start_dateStart DateUTC date and time in the format YYYY-MM-DDTHH:MM:SSZ. Data added on and after this date will be captured. If left blank, defaults to 30 days before the present.string30 days ago
/scheduled_event_lookback_monthsScheduled Event Lookback (Months)Number of months before the current date to include when fetching scheduled events. Must be at least 1.integer1
/scheduled_event_lookahead_monthsScheduled Event Lookahead (Months)Number of months after the current date to include when fetching scheduled events. Must be at least 1.integer6

Bindings

PropertyTitleDescriptionTypeRequired/Default
/nameNameName of the Calendly resource.stringRequired
/intervalIntervalInterval between data syncs.stringPT5M

Sample

captures:
${PREFIX}/${CAPTURE_NAME}:
endpoint:
connector:
image: ghcr.io/estuary/source-calendly:v1
config:
credentials:
access_token: <secret>
start_date: "2024-01-01T00:00:00Z"
bindings:
- resource:
name: event_types
interval: PT5M
target: ${PREFIX}/event_types
- resource:
name: scheduled_events
interval: PT5M
target: ${PREFIX}/scheduled_events
- resource:
name: event_invitees
interval: PT5M
target: ${PREFIX}/event_invitees
{...}