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

# List webhooks

`GET /webhooks`

## Request

- Base URL: `https://api.tally.so`
- URL: `https://api.tally.so/webhooks`
- Auth: HTTP bearer

Returns a paginated list of all webhooks across your accessible forms and workspaces.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

List of webhooks

- object
  - `webhooks` object[]: List of webhooks
    - `id` string: Webhook ID
    - `formId` string: Form ID the webhook is attached to
    - `url` string: The webhook endpoint URL
    - `signingSecret` string, nullable: Secret used to sign webhook payloads
    - `httpHeaders` object[], nullable: Custom HTTP headers to include in webhook requests
      - `name` string: Header name
      - `value` string: Header value
    - `eventTypes` EventType[]: Types of events this webhook subscribes to
    - `externalSubscriber` string, nullable: External subscriber identifier
    - `isEnabled` boolean: Whether the webhook is enabled
    - `lastSyncedAt` string, date-time, nullable: When the webhook was last synced
    - `createdAt` string, date-time: When the webhook was created
    - `updatedAt` string, date-time: When the webhook was last updated
  - `page` number: Current page number
  - `limit` number: Number of webhooks per page
  - `hasMore` boolean: Whether there are more pages available
  - `totalCount` number: Total number of webhooks

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

## Changes

- **2026-10-20** `94800fcb99ad`: 2 breaking
  - for the `query` request parameter `limit`, the type changed from `number` to `integer`
  - for the `query` request parameter `page`, the type changed from `number` to `integer`

[Operation history](https://skmtc.dev/tally/apis/tally-api/changes/webhooks/get.md)

---

[API](https://skmtc.dev/tally/apis/tally-api.md) - [All operations](https://skmtc.dev/tally/apis/tally-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tally/apis/tally-api/revisions/8b37e41e11fa?raw)