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

# List Webhooks

`GET /v1/webhooks`

Returns a paginated list of webhooks for the account, sorted by most recently created first. Use agentId to filter by agent and active to filter by enabled/disabled status. Use page and size to navigate through results.

## Query parameters

- `agentId` string
- `active` boolean
- `page` integer
- `size` integer

## Response `200`

OK

- PaginatedResponseWebhookResponse — Standard wrapper for paginated API responses. Use this when returning list data that is split across multiple pages. Includes the current page of results along with pagination metadata to help clients navigate through large datasets efficiently.
  - `data` WebhookResponse[] — List of items for the current page. Contains up to 'size' number of records.
    - `workspaceId` string — Unique identifier of the workspace this webhook belongs to. Use this value to scope queries or filter webhooks by workspace.
    - `webhookId` string — Unique identifier for this webhook. Use this value as webhookId when updating, deleting, or retrieving this webhook via the API.
    - `name` string — Display name of this webhook as set at creation time. Used to identify it in listings and dashboards.
    - `agentId` string — Unique identifier of the agent this webhook is scoped to. Only events originating from this agent are delivered to this webhook's URL.
    - `active` boolean — Whether this webhook is currently active and will receive event deliveries. When false, the webhook is registered but no events are sent to the URL. Toggle this to pause or resume delivery without deleting the webhook.
    - `secret` string — HMAC secret key used to sign outgoing webhook payloads. The system includes a signature header on each delivery computed using this secret. Verify the signature on your server to confirm payloads are genuinely from SigmaMind. Store this value securely — it is only returned at creation time.
    - `events` string[] — Event types this webhook is subscribed to. Only events in this list trigger a delivery to the webhook URL. 'conversation_started' fires when an agent session begins. 'conversation_ended' fires when a session closes. 'conversation_analysed' fires when post-call analysis is complete.
    - `url` string
  - `page` integer — Current page number (0-based index). Indicates which page of results is being returned.
  - `size` integer — Number of items requested per page. Determines the maximum size of the 'data' list.
  - `totalCount` integer — Total number of records available across all pages. Useful for calculating pagination on the client side.
  - `totalPages` integer — Total number of pages available based on totalCounts and size. Helps clients understand how many pages exist in total.
  - `hasNext` boolean — Indicates whether there is a next page available after the current one. Useful for implementing 'Load More' or next navigation.
  - `hasPrevious` boolean — Indicates whether there is a previous page before the current one. Useful for enabling backward navigation.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/sigmamind/apis/sigmamind-apis.md) · [All operations](https://skmtc.net/sigmamind/apis/sigmamind-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sigmamind/sigmamind-apis/versions/d00f52b5123f/schema)