---
canonical_url: "https://docs.composio.dev/toolkits/savvycal"
markdown_url: "https://docs.composio.dev/toolkits/savvycal.md"
product: "platform"
version: null
last_updated: null
---

# SavvyCal

SavvyCal is a scheduling platform for managing booking links, availability, events, workflows, and webhooks.

- **Category:** scheduling & booking
- **Auth:** OAUTH2, API_KEY
- **Composio-managed OAuth available?** No
- **Tools:** 22
- **Triggers:** 0
- **Slug:** `SAVVYCAL`
- **Version:** 00000000_00

## Tools

### Book Event

**Slug:** `SAVVYCAL_BOOK_EVENT`

Book a SavvyCal event using the exact start_at and end_at of one slot from LIST_AVAILABLE_TIME_SLOTS. Do not retry speculatively: more than 10 event-creation attempts on the same link in one minute returns 429, and failed attempts count toward that limit. Conferencing join data may be attached asynchronously after the booking response.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Scheduler's email address. |
| `end_at` | string | Yes | Exact RFC 3339 end_at from the same slot as start_at returned by LIST_AVAILABLE_TIME_SLOTS; do not derive or alter it. |
| `fields` | array | No | Scheduler answers to custom fields from GET_SCHEDULING_LINK. Preserve each field's ID, type, label, and selected option IDs and text. |
| `link_id` | string | Yes | SavvyCal scheduling-link ID on which to book the event. |
| `metadata` | object | No | Arbitrary custom metadata to attach to the created event. |
| `start_at` | string | Yes | Exact RFC 3339 start_at from one slot returned by LIST_AVAILABLE_TIME_SLOTS; do not round or alter it. |
| `last_name` | string | No | Scheduler's last name. Required only when the scheduling link asks for separate first and last names; ignored on other links. |
| `time_zone` | string | Yes | Scheduler's local Olson/IANA time-zone ID. |
| `first_name` | string | No | Scheduler's first name. Required only when the scheduling link asks for separate first and last names; ignored on other links. |
| `display_name` | string | No | Scheduler's full name. Required unless the scheduling link asks for first and last names separately. |
| `phone_number` | string | No | Scheduler phone number formatted like +15555555555. Required when the link's Always gather phone number setting is enabled. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cancel Event

**Slug:** `SAVVYCAL_CANCEL_EVENT`

Irreversibly cancel a cancelable SavvyCal event, optionally recording a cancellation reason. Already canceled or non-cancelable events are reported as not found.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_id` | string | Yes | SavvyCal event ID or UUID to cancel. |
| `cancel_reason` | string | No | Optional cancellation reason to record; null is accepted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Personal Scheduling Link

**Slug:** `SAVVYCAL_CREATE_PERSONAL_SCHEDULING_LINK`

Create a recurring or single-use scheduling link in the connected user's personal scope.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Public name shown on the scheduling link. |
| `slug` | string | No | URL slug containing letters, numbers, and dashes, unique within the personal scope. SavvyCal generates one when omitted. |
| `type` | string ("recurring" | "single") | No | Link usage type: recurring creates a multi-use link, while single creates a single-use link. |
| `description` | string | No | Short public description for the scheduling link; null is accepted. |
| `private_name` | string | No | Private internal name not shown to schedulers; null is accepted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Scoped Scheduling Link

**Slug:** `SAVVYCAL_CREATE_SCOPED_SCHEDULING_LINK`

Create a recurring or single-use scheduling link in a personal or team scope managed by the connected user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Public name shown on the scheduling link. |
| `slug` | string | No | URL slug containing letters, numbers, and dashes and unique within the selected scope. SavvyCal generates one when omitted. |
| `type` | string ("recurring" | "single") | No | Link usage type: recurring creates a multi-use link, while single creates a single-use link. |
| `scope_slug` | string | Yes | Slug of a managed personal or team scope, obtained from a link or event scope preview. Use 'personal' for the personal scope where supported. |
| `description` | string | No | Short public description for the scheduling link; null is accepted. |
| `private_name` | string | No | Private internal name not shown to schedulers; null is accepted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Webhook

**Slug:** `SAVVYCAL_CREATE_WEBHOOK`

Register a public HTTPS callback URL for SavvyCal webhook deliveries. SavvyCal returns a signing secret in the provider response and uses that secret to sign the x-savvycal-signature header on each delivery; store it securely.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Public HTTPS callback URL that will receive SavvyCal webhook deliveries. Do not use embedded credentials, localhost, or a private-network IP. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Scheduling Link

**Slug:** `SAVVYCAL_DELETE_SCHEDULING_LINK`

Delete a scheduling link and return the link with its resulting deleted state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `link_id` | string | Yes | SavvyCal scheduling-link ID to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Webhook

**Slug:** `SAVVYCAL_DELETE_WEBHOOK`

Delete a registered SavvyCal webhook and return it with its resulting deleted state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | string | Yes | SavvyCal webhook ID to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Duplicate Scheduling Link

**Slug:** `SAVVYCAL_DUPLICATE_SCHEDULING_LINK`

Create a copy of an existing scheduling link; SavvyCal generates a new link ID and slug.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `link_id` | string | Yes | SavvyCal ID of the scheduling link to copy. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current User

**Slug:** `SAVVYCAL_GET_CURRENT_USER`

Return the connected SavvyCal user's identity, time preferences, and account plan.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Event

**Slug:** `SAVVYCAL_GET_EVENT`

Get one SavvyCal event by event ID or UUID, including attendees, custom-field answers, cancellation details, and reschedule metadata.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_id` | string | Yes | SavvyCal event ID or UUID to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Scheduling Link

**Slug:** `SAVVYCAL_GET_SCHEDULING_LINK`

Get one scheduling link, including booking-field definitions, availability summary, and scope preview.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `link_id` | string | Yes | SavvyCal scheduling-link ID to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Time Zone

**Slug:** `SAVVYCAL_GET_TIME_ZONE`

Get one IANA time-zone record and its offset, DST state, names, mappings, and current period boundaries at an optional instant.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `instant` | string | No | RFC 3339 instant at which to calculate the zone details; defaults to now. |
| `time_zone` | string | Yes | IANA time-zone ID such as America/Chicago. Preserve its slash-separated path form. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Webhook

**Slug:** `SAVVYCAL_GET_WEBHOOK`

Get one registered SavvyCal webhook by ID, including its delivery URL, state, signing secret, payload version, and creation time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | string | Yes | SavvyCal webhook ID to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Available Time Slots

**Slug:** `SAVVYCAL_LIST_AVAILABLE_TIME_SLOTS`

Return all available booking slots for a scheduling link within an optional RFC 3339 window of at most 31 days. Multiple durations may overlap. Ranked availability is cumulative, so select an expanded level with rank == N. SavvyCal's response order is preserved and is not guaranteed to be chronological.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `from` | string | No | RFC 3339 start instant; defaults to the current time. |
| `until` | string | No | RFC 3339 end instant; defaults to seven days after from and must be no more than 31 days after from. |
| `link_id` | string | Yes | SavvyCal scheduling-link ID whose booking availability to inspect. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Events

**Slug:** `SAVVYCAL_LIST_EVENTS`

List one page of accessible SavvyCal events with state, date-period, attendance, scheduling-link, time-zone, and text filters. Returns rich attendee, custom-field, cancellation, and rescheduling details plus forward and backward pagination cursors.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `link` | string | No | Scheduling-link ID to filter by, or 'any' for every link. |
| `after` | string | No | Opaque metadata.after cursor from a prior response for the next page; pass it unchanged and do not combine it with before. |
| `limit` | integer | No | Maximum events to return on this page (1-100). |
| `query` | string | No | Text matched against the event summary and description, scheduling-link name and description, and attendee names and email addresses. The documented input name 'q' is also accepted. |
| `state` | string ("all" | "any" | "confirmed" | "canceled" | "awaiting_reschedule" | "awaiting_checkout" | "checkout_expired" | "awaiting_approval" | "declined" | "tentative") | No | Event-state filter. 'tentative' groups awaiting checkout, approval, and reschedule; 'canceled' groups canceled and declined; 'all' and 'any' match every state. When omitted, SavvyCal chooses awaiting_approval when applicable and confirmed otherwise. |
| `until` | string | No | Last date of a fixed range, interpreted through the end of day in time_zone. The fixed period applies no time filter unless from_date is also provided. |
| `before` | string | No | Opaque metadata.before cursor from a prior response for the previous page; pass it unchanged and do not combine it with after. |
| `period` | string ("past" | "upcoming" | "fixed" | "all") | No | Time-period filter. 'fixed' matches events overlapping from_date through until; it applies no time filter unless both dates are provided. |
| `direction` | string ("asc" | "desc") | No | Sort direction by event start time. |
| `from_date` | string | No | First date of a fixed range, interpreted from the start of day in time_zone. The documented input name 'from' is also accepted. |
| `time_zone` | string | No | IANA time-zone ID used to interpret fixed-period dates. Defaults to the connected user's time zone, including when SavvyCal does not recognize the supplied ID. |
| `attendance` | string ("attending" | "any") | No | 'attending' returns events the connected user attends; 'any' returns every event the user can access. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Scheduling Links

**Slug:** `SAVVYCAL_LIST_SCHEDULING_LINKS`

List one page of scheduling links accessible to the connected user, with optional state, managed-scope, and text filters. Returns SavvyCal's native forward and backward cursors plus a next_cursor for continuation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Opaque metadata.after cursor from a prior response for the next page; pass it unchanged and do not combine it with before. |
| `limit` | integer | No | Maximum scheduling links to return on this page (1-100). |
| `query` | string | No | Search words; every word must match the link name, private name, description, slug, or scope slug. |
| `scope` | string | No | SavvyCal scope ID to filter by, or 'any'. Use the ID from a returned scope preview, not its slug. |
| `state` | string ("active" | "pending" | "disabled" | "archived") | No | Return only links in this state. When omitted, SavvyCal returns active, pending, and disabled links. |
| `before` | string | No | Opaque metadata.before cursor from a prior response for the previous page; pass it unchanged and do not combine it with after. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Time Zones

**Slug:** `SAVVYCAL_LIST_TIME_ZONES`

List SavvyCal's complete IANA time-zone catalog at an optional RFC 3339 instant, including offsets, daylight-saving periods, localized metazone names, aliases, and Windows mappings. The response is unpaginated and can contain hundreds of records.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `instant` | string | No | RFC 3339 instant at which to calculate names, offsets, daylight-saving state, and period boundaries. Defaults to the current time. |
| `include_legacy` | boolean | No | Whether to include legacy zones such as EST. Only true includes legacy zones; omitted or false excludes them. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Webhooks

**Slug:** `SAVVYCAL_LIST_WEBHOOKS`

List one page of webhook registrations managed by the connected user, including each receiver URL, state, version, signing secret, and creation time. Returns native forward and backward pagination cursors.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Opaque metadata.after cursor from a prior response for the next page; pass it unchanged and do not combine it with before. |
| `limit` | integer | No | Maximum webhooks to return on this page (1-100). |
| `before` | string | No | Opaque metadata.before cursor from a prior response for the previous page; pass it unchanged and do not combine it with after. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Workflow Rules

**Slug:** `SAVVYCAL_LIST_WORKFLOW_RULES`

List every trigger rule and configured action for one SavvyCal workflow, including trigger offsets and open action-specific properties.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `workflow_id` | string | Yes | SavvyCal workflow ID whose rules and configured actions to return. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Workflows

**Slug:** `SAVVYCAL_LIST_WORKFLOWS`

List one page of workflows in scopes managed by the connected user, including each workflow's state and creation time. Returns native forward and backward pagination cursors.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Opaque metadata.after cursor from a prior response for the next page; pass it unchanged and do not combine it with before. |
| `limit` | integer | No | Maximum workflows to return on this page (1-100). |
| `before` | string | No | Opaque metadata.before cursor from a prior response for the previous page; pass it unchanged and do not combine it with after. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Toggle Scheduling Link

**Slug:** `SAVVYCAL_TOGGLE_SCHEDULING_LINK`

Invert a scheduling link's current enabled state: disable an active or pending link, or enable a disabled or archived link. This operation is not idempotent: every successful call reverses the current state, so an automatic retry can undo the first call. Inspect the returned state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `link_id` | string | Yes | SavvyCal scheduling-link ID whose enabled state will be inverted. Each call toggles the current state, so do not retry automatically. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Scheduling Link

**Slug:** `SAVVYCAL_UPDATE_SCHEDULING_LINK`

Update one or more basic properties of an existing SavvyCal scheduling link. Omitted properties remain unchanged; description and private_name can be explicitly cleared with null.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New public link name. |
| `slug` | string | No | New URL slug containing only letters, numbers, and dashes and unique within the link's scope. |
| `type` | string ("recurring" | "single") | No | New link type. Group links cannot be changed to single. |
| `link_id` | string | Yes | SavvyCal scheduling-link ID to update. |
| `description` | string | No | New public description; send null explicitly to clear it. |
| `private_name` | string | No | New private internal name; send null explicitly to clear it. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
