--- title: Calendly API Integration on Truto slug: calendly category: Scheduling canonical: "https://truto.one/integrations/detail/calendly/" --- # Calendly API Integration on Truto **Category:** Scheduling **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Licenses** — Licenses represent concepts like user seats in apps that support them - **Users** — The User object represents a User. ### Unified Calendar API - **Availability** — Represents the availability of a person in a time period. - **Event Types** — - **Events** — Events are the time-bound tasks that are associated with a calendar. ## How it works 1. **Link your customer's Calendly account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Calendly.** The Proxy API is a 1-to-1 mapping of the Calendly API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Auto-log booked meetings against CRM contacts** — CRM and sales platforms integrate Calendly so that when a prospect books a demo or discovery call, the event details—time, duration, invitee responses—are automatically logged on the contact record without manual data entry. - **Embed scheduling links inside outreach sequences** — Sales engagement and email sequencing tools fetch a rep's Calendly event types so they can insert the right booking link into automated cadences, and pause the sequence automatically once a meeting is booked. - **Trigger candidate pipeline updates on interview booking** — Applicant tracking systems use Calendly event data to move candidates through hiring stages—updating status to 'Interview Scheduled' the moment a candidate picks a time slot, keeping the pipeline accurate in real time. - **Surface scheduling inside customer onboarding checklists** — Client onboarding and customer success platforms pull the assigned manager's Calendly availability and event types directly into the portal, letting new customers book their kickoff call without leaving the product. - **Map Calendly users to internal tenant accounts** — Multi-tenant SaaS products need to associate each end-user's Calendly identity with the correct internal account for accurate attribution, routing, and access control across their platform. ## What you can build - **In-app meeting link picker** — Fetch a user's Calendly event types and render them in a dropdown so they can insert the exact booking link—15-min intro, 30-min demo—directly into an email composer or chat message. - **Real-time event sync to contact timeline** — Listen for new Calendly bookings and cancellations via webhooks and automatically append event details, invitee custom question responses, and meeting links to a contact or candidate's activity timeline. - **Availability-aware scheduling UI** — Query a user's Calendly availability windows and display open time slots natively inside your product, so invitees never have to leave your app to find a meeting time. - **Automated sequence pause on booking** — When a Calendly event is created, automatically pause or exit the prospect from an active outreach sequence to prevent awkward follow-up emails after they've already scheduled a call. - **User-to-account mapping dashboard** — Pull Calendly user profiles—email, scheduling URL, and avatar—via the Unified User Directory API to let admins map each team member's Calendly account to the correct internal seat or workspace. - **Onboarding intake auto-fill from invitee responses** — Capture custom question answers from Calendly event payloads and pre-populate onboarding forms, CRM fields, or intake documents so customers never have to re-enter information they already provided when booking. ## FAQs ### What authentication method does the Calendly integration use? Calendly supports OAuth 2.0 for user-level authorization. Truto handles the full OAuth flow—token exchange, storage, and refresh—so your team never manages credentials directly. ### Which Truto Unified APIs cover Calendly? Calendly is mapped to the Unified Calendar API (Availability, Event Types, Events) and the Unified User Directory API (Users, Licenses). These let you read scheduling data and user profiles through a consistent schema across multiple scheduling tools. ### How do I get real-time updates when meetings are booked or canceled? Calendly supports webhooks for events like invitee.created and invitee.canceled. Subscribing to these through the integration gives you near-instant notifications, which is far more efficient than polling the scheduled events endpoint. ### Can I access custom question responses submitted by invitees? Yes. When an invitee books a meeting and fills out custom questions (e.g., company size, use case), those responses are included in the event payload. You can use this data to enrich contact profiles or auto-fill forms in your product. ### Does the integration handle Calendly's API rate limits and pagination? Truto manages rate-limit handling and pagination automatically. Your application makes straightforward requests through the Unified API, and Truto takes care of retries, backoff, and cursor-based pagination behind the scenes. ### What if I need a Calendly capability that isn't covered by the current Unified APIs? Truto builds additional tools and resource mappings on request. If you need access to specific Calendly endpoints—like single-use scheduling links or Round Robin configuration—reach out and the Truto team can add support.