Calendly

• You want an AI agent to check a user's Calendly availability before suggesting meeting times.
• You need to list, retrieve, or cancel scheduled events programmatically as part of a workflow.
• You are building an automation that reacts to booking activity by setting up or managing Calendly webhooks (invitee.created, invitee.canceled).
• You need to programmatically book a meeting by creating an invitee against a known event type (requires a paid Calendly plan).

• You need to create or modify event types — the Calendly API does not support this, and neither does this skill.
• You need availability windows longer than 7 days in a single request — the availability endpoints enforce this limit.
• You are on Calendly's free plan and need webhooks or the scheduling (invitee creation) API — those features require a paid plan.

All requests are proxied through gateway.maton.ai, which automatically injects your Calendly OAuth token. You authenticate once with your MATON_API_KEY and never manage OAuth refresh flows yourself.

List, retrieve, and cancel scheduled events with rich filtering by status, invitee email, time range, and user. Paginate through large result sets using page_token.

Query available time slots for a specific event type (/event_type_available_times) or retrieve a user's busy blocks (/user_busy_times) and configured availability schedules — up to 7 days per request.

List and inspect invitees for any scheduled event, including their answers to intake questions, cancel/reschedule URLs, and tracking data. Create invitees programmatically to book meetings on behalf of users (paid Calendly plan required).

Create, list, and delete webhook subscriptions scoped to a user or organization. Supported events include invitee.created, invitee.canceled, and routing_form_submission.created (paid Calendly plan required).

Manage multiple Calendly OAuth connections under one MATON_API_KEY. Target a specific connection per request using the Maton-Connection header, or let the gateway use the default active connection.

An agent checks a user's available Calendly slots for the next 5 days, presents options in a chat interface, and books the chosen slot by creating an invitee — all without the user leaving the conversation.

A daily automation pulls all active scheduled events for a sales team, enriches them with invitee details and intake answers, and posts a structured briefing to Slack or a CRM.

Register a webhook for invitee.created and invitee.canceled events on an organization, then trigger downstream actions (send confirmation emails, update a database, notify a Slack channel) whenever a booking changes.

Before auto-scheduling a recurring task or reminder, an agent queries user_busy_times to avoid conflicts with existing calendar blocks, then selects a free window that fits the user's availability schedule.