Calendly Block

The Calendly block integrates Calendly scheduling into your workflows. Use it to list event types, view scheduled events, manage invitees, and cancel appointments directly from a workflow run.

Overview

When to Use

• List all event types configured for a Calendly user or organization.
• Fetch details for a specific event type by its UUID.
• Retrieve scheduled events for a user or organization, with optional date and status filters.
• Get full details of a single scheduled event.
• List the invitees attached to a scheduled event, with optional email and status filters.
• Cancel an existing appointment programmatically.
• Trigger a workflow automatically when an invitee books or cancels a meeting

Configuration

Operation

Required. A dropdown selecting which Calendly action to run. Every option maps to a dedicated tool:

Personal Access Token (apiKey)

Required. Your Calendly Personal Access Token, stored as a password field. Sent as a Bearer token on every request.

Event Type UUID (eventTypeUuid)

The UUID (or full URI) of the target event type. Shown only for the Get Event Type and List Event Invitees operations.

User URI (user)

The Calendly user URI (e.g. https://api.calendly.com/users/xxx). Shown only for the List Event Types and List Scheduled Events operations.

Organization URI (organization)

The Calendly organization URI (e.g. https://api.calendly.com/organizations/xxx). Shown only for the List Scheduled Events operation.

Trigger Configuration

• Type: trigger-config
• Available triggers: calendly_webhook

When the block runs in trigger mode, this configures the calendly_webhook trigger so booking events start the workflow. The signing key is verified against the Calendly-Webhook-Signature header on every delivery. See the Calendly webhook trigger for the full output schema and setup steps.

Inputs & Outputs

Inputs:

• operation (string) — Operation to perform
• apiKey (string) — API token
• eventTypeUuid (string) — Event type UUID
• user (string) — User URI
• organization (string) — Organization URI

Outputs:

• eventTypes (json) — Event types
• events (json) — Scheduled events
• invitees (json) — Event invitees

Trigger outputs

When running in trigger mode the block emits the webhook event instead: event (string), invitee_name (string), invitee_email (string), invitee_status (string), start_time (string), end_time (string), event_name (string), join_url (string), reschedule_url (string), cancel_url (string), cancel_reason (string), answers (json — keyed by question text). See the calendly webhook trigger for the full schema.

Tools

Calendly Get Current User (calendly_get_current_user) — Fetches information about the currently authenticated Calendly user. Requires only apiKey. Returns a resource object with user details.

Calendly List Event Types (calendly_list_event_types) — Retrieves all event types for a user or organization. Accepts optional user, organization, count, pageToken, sort, and active params. Returns a collection array and pagination object.

Calendly Get Event Type (calendly_get_event_type) — Fetches detailed information about one event type by its UUID or full URI. Requires apiKey and eventTypeUuid. Returns a resource object with event type details.

Calendly List Scheduled Events (calendly_list_scheduled_events) — Retrieves scheduled events for a user or organization. At least one of user or organization is required. Accepts optional filters: invitee_email, count, min_start_time, max_start_time, pageToken, sort, and status (active or canceled). Returns a collection array and pagination object.

Calendly Get Scheduled Event (calendly_get_scheduled_event) — Fetches full details of a single scheduled event by UUID or full URI. Requires apiKey and eventUuid. Returns a resource object with event details.

Calendly List Event Invitees (calendly_list_event_invitees) — Retrieves invitees for a scheduled event. Requires apiKey and eventUuid. Accepts optional filters: count, email, pageToken, sort, and status. Returns a collection array and pagination object.

Calendly Cancel Event (calendly_cancel_event) — Cancels a scheduled event. Requires apiKey and eventUuid. Accepts an optional reason string. Returns a resource object with cancellation details.

YAML Example

calendly_1:
  type: calendly
  name: "Calendly"
  inputs:
    operation: "calendly_list_scheduled_events"
    apiKey: "{{CALENDLY_TOKEN}}"
    user: "https://api.calendly.com/users/xxx"
    organization: "https://api.calendly.com/organizations/xxx"
  connections:
    outgoing:
      - target: next-block-id