Webhooks

Endpoints for creating, reading, and deleting webhooks.

get
List Webhooks

https://api.savvycal.com/v1/webhooks
This endpoint allows you to list your webhooks.
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 webhooks.
{
"entries": [
// items
],
"metadata": {
"before": null,
"after": null,
"limit": 20
}
}

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

get
Get Webhook

https://api.savvycal.com/v1/webhooks/:webhook_id
This endpoint allows you to fetch a single webhook.
Request
Response
Request
Headers
Authorization
required
string
Bearer <your-access-token>
Response
200: OK
Returns the webhook.
{
"id": "wh_XXXXX",
// ...
}

When successful, returns a Webhook resource with a 200 status code.

post
Create Webhook

https://api.savvycal.com/v1/webhooks
This endpoint allows you to create a new webhook.
Request
Response
Request
Headers
Content-Type
required
string
application/json
Authorization
required
string
Bearer <your-access-token>
Body Parameters
url
required
string
The URL to receive HTTP POST requests.
Response
201: Created
Returns the webhook.
{
"id": "wh_XXXXX",
// ...
}
422: Unprocessable Entity
Returns validation errors.
{
"errors": {
"url": ["must be a valid URL"]
}
}

When successful, returns the new Webhook resource with a 201 status code.

delete
Delete Webhook

https://api.savvycal.com/v1/webhooks/:webhook_id
This endpoint allows you to delete a webhook.
Request
Response
Request
Headers
Authorization
required
string
Bearer <your-access-token>
Response
200: OK
Returns the deleted webhook.
{
"id": "wh_XXXXX",
"state": "deleted",
// ...
}

When successful, returns the deleted Webhook resource with a 200 status code.