---
title: "List webhooks"
method: GET
path: "/v1/webhooks"
tags: ["Webhooks"]
---

# List webhooks

`GET /v1/webhooks`

## Request

- Base URL: `https://api.savvycal.com`
- URL: `https://api.savvycal.com/v1/webhooks`
- Auth: one of:
  - OAuth 2
    - Authorization code: `/oauth/authorize`
    - Token URL: `/oauth/token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/savvycal/apis/savvycal-meetings-api/docs/v1/webhooks/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `limit` integer
- `after` string
- `before` string

## Response `200`

Success

- WebhookListResponse
  - `entries` Webhook[], required
    - `created_at` string, date-time, required
    - `id` string, required
    - `secret` string, required: The key that signs each delivery. The `x-savvycal-signature` header is `sha256=` followed by the hex HMAC-SHA256 of the request body.
    - `state` 'active' | 'disabled' | 'deleted', required
    - `url` string, uri, required
    - `version` string, required
  - `metadata` PaginationMeta, required
    - `after` string, nullable: Pass as `after` to get the next page. `null` on the last page.
    - `before` string, nullable: Pass as `before` to get the previous page. `null` on the first page.
    - `limit` integer, required

## Other responses

- `400`: Invalid `after` or `before` cursor
- `401`: Unauthorized

---

[API](https://skmtc.dev/savvycal/apis/savvycal-meetings-api.md) - [All operations](https://skmtc.dev/savvycal/apis/savvycal-meetings-api/llms.txt) - [OpenAPI document](https://skmtc.dev/savvycal/apis/savvycal-meetings-api/revisions/398985d699a3?raw)