Scheduling Links

Endpoints for creating, reading, and updating scheduling links.
https://api.savvycal.com/v1/links
This endpoint allows you to list your scheduling links.
Request
Response
Request
Headers
Authorization
required
string
Bearer <your-access-token>
Query Parameters
before
optional
string
A pagination cursor for entries before a specific point in the collection.
after
optional
string
A pagination cursor for entries after a specific point in the collection.
limit
optional
integer
The maximum number of entries to retrieve (defaults to 20, up to 100 allowed).
Response
200: OK
Returns a paginated list of scheduling link resources.
{
"entries": [
// items
],
"metadata": {
"before": nil,
"after": "g3QAAAABZAACaWRiAAAbFA==",
"limit": 20
}
}

When successful, returns a Paginated List of Scheduling Link resources with a 200 status code.

https://api.savvycal.com/v1/links/:link_id
This endpoint allows you to fetch a single scheduling link.
Request
Response
Request
Headers
Authorization
required
string
Bearer <your-access-token>
Response
200: OK
Returns a scheduling link.
{
"id": "link_01ED74HMFGVZ92YVCWTD8Y8H6X",
// ...
}

When successful, returns a Scheduling Link resource with a 200 status code.

https://api.savvycal.com/v1/scopes/:scope/links
This endpoint allows you to create a scheduling link.
Request
Response
Request
Path Parameters
scope
optional
string
The slug for the user or team under which to create the link. To create the link under the user's personal scope, you may use "personal".
Headers
Authorization
required
string
Bearer <your-access-token>
Body Parameters
name
required
string
The name of the scheduling link.
private_name
optional
string
The private name of the link (not visible to schedulers).
description
optional
string
The short description visible on the scheduling link.
Response
201: Created
Returns the newly-created scheduling link.
{
"id": "link_01ED74HMFGVZ92YVCWTD8Y8H6X",
// ...
}

When successful, returns a Scheduling Link resource with a 201 status code.

https://api.savvycal.com/v1/links/:link_id/toggle
This endpoint allows you to toggle the active/disabled state of a scheduling link.
Request
Response
Request
Headers
Authorization
required
string
Bearer <your-access-token>
Response
200: OK
Returns the updated scheduling link.
{
"id": "link_01ED74HMFGVZ92YVCWTD8Y8H6X",
// ...
}

When successful, returns a Scheduling Link resource with a 200 status code.

https://api.savvycal.com/v1/links/:link_id
This endpoint allows you to delete a scheduling link.
Request
Response
Request
Headers
Authorization
required
string
Bearer <your-access-token>
Response
200: OK
Returns the deleted scheduling link.
{
"id": "link_01ED74HMFGVZ92YVCWTD8Y8H6X",
// ...
}

When successful, returns a Scheduling Link resource with a 200 status code.