# Calendly

> Calendly scheduling via API v2 - manage event types, booked meetings, invitees, availability, links, webhooks and org admin.

Lets an agent run your Calendly account through the API v2 - list and create booking pages, read booked meetings and their invitees, generate single-use scheduling links, manage availability, set up webhooks, and handle organization admin.

## What it can do

| Method | What it does |
| --- | --- |
| `calendly_me` | Get the authenticated user; returns the user URI and organization URI the other actions need. Call this first. |
| `calendly_list_org_memberships` | List organization members; optional email filter. |
| `calendly_list_event_types` | List event types (booking pages) for a user or organization. |
| `calendly_get_event_type` | Get one event type by UUID. |
| `calendly_list_scheduled_events` | List scheduled (booked) meetings; filter by status and start-time window. |
| `calendly_get_scheduled_event` | Get one scheduled meeting by UUID. |
| `calendly_list_event_invitees` | List the invitees (attendees) of a meeting. |
| `calendly_cancel_event` | Cancel a meeting, with an optional reason (write). |
| `calendly_list_availability_schedules` | List a user's availability schedules. |
| `calendly_list_busy_times` | List a user's busy times in a window (range up to 7 days). |
| `calendly_create_scheduling_link` | Create a single-use scheduling link for an event type; returns the booking URL (write). |
| `calendly_list_webhooks` | List webhook subscriptions for a user or organization. |
| `calendly_create_webhook` | Create a webhook subscription for given events (write). |
| `calendly_delete_webhook` | Delete a webhook subscription by UUID (write). |
| `calendly_list_event_type_availability_schedules` | List an event type's availability schedules and rules; read before updating. |
| `calendly_update_event_type_availability` | Overwrite an event type's availability schedule with a full rule set (write). |
| `calendly_get_event_type_available_times` | List bookable time slots for an event type in a window (range up to 7 days). |
| `calendly_get_user_availability_schedule` | Get one user availability schedule by UUID. |
| `calendly_create_event_type` | Create a one-on-one event type (booking page) (write). |
| `calendly_update_event_type` | Update a one-on-one event type by UUID (write). |
| `calendly_create_one_off_event_type` | Create a one-off, single-use event type (write). |
| `calendly_get_invitee` | Get one invitee of a scheduled event. |
| `calendly_mark_no_show` | Mark an invitee as a no-show (write). |
| `calendly_delete_no_show` | Un-mark an invitee no-show (write). |
| `calendly_get_org_membership` | Get one organization membership by UUID. |
| `calendly_remove_org_membership` | Remove a member from the organization (write). |
| `calendly_list_org_invitations` | List organization invitations; optional email filter. |
| `calendly_create_org_invitation` | Invite a person to the organization by email (write). |
| `calendly_revoke_org_invitation` | Revoke an organization invitation (write). |
| `calendly_list_groups` | List organization groups. |
| `calendly_get_group` | Get one group by UUID. |
| `calendly_list_activity_log` | List organization activity log entries. |
| `calendly_delete_invitee_data` | Delete invitee scheduling data for given emails (GDPR, irreversible, write). |
| `calendly_delete_event_data` | Delete scheduled-event data in a time range (GDPR, irreversible, write). |

## How to get credentials

Calendly uses a Personal Access Token (PAT) with Bearer auth.

1. Open [calendly.com/integrations/api_webhooks](https://calendly.com/integrations/api_webhooks).
2. Go to Integrations & apps - API & webhooks.
3. Under Personal access tokens, click Generate New Token.
4. Name it (e.g. *FlyMyAI Agent*) and copy the token - it is shown only once.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `CALENDLY_API_KEY` | Calendly - Integrations & apps - API & webhooks - Generate New Token |