Calendly — Application Overview

Calendly is a scheduling automation platform used by sales teams, recruiters, customer-success teams, consultants, and operational teams to coordinate meetings and availability across calendars. The Calendly integration within the Wrk platform allows you to automate scheduling workflows by calling the Calendly REST API through prebuilt Wrk Actions.

This document provides an overview of how Calendly integrates into Wrk, how authentication works, general API behaviour, and a full list of available Wrk Actions.

Authentication

Calendly uses OAuth 2.0 authentication for secure access.

Create a new Calendly Connected Account in Wrk.
Sign in with your Calendly account.
Review and approve the requested permissions.
Complete the authorization flow to allow Wrk access to your Calendly account.

Important Notes

OAuth scopes and available resources depend on the user role.
Admin and Owner accounts have broader organization-level access.
Revoking tokens or changing permissions requires reauthentication inside Wrk.

General API Behaviour

REST API Structure

Calendly API v2 is a REST API that uses JSON request and response payloads. Most entities returned by Calendly follow a predictable resource-oriented structure.

Common entities include:

Users
Event Types
Scheduled Events
Invitees
Organization Memberships
Webhook Subscriptions

Each entity generally includes:

uri — unique resource identifier
resource type metadata
timestamps such as created_at or updated_at

Pagination

Calendly uses cursor-based pagination for large collection endpoints.

Paginated responses commonly include:

collection
pagination
next_page_token

Requests can typically include:

count — number of records to return
page_token — token used to retrieve the next page

Important notes:

Pagination tokens should only be used within the same retrieval sequence.
Large organizations and scheduling datasets should always use paginated retrievals.
Maximum page sizes vary by endpoint.