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.

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.

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

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