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

# List Workspace Webhooks

`GET /v1/workspace/webhooks`

List all webhooks for a workspace

## Query parameters

- `include_usages` boolean — Whether to include active usages of the webhook, only usable by admins

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- WorkspaceWebhookListResponseModel
  - `webhooks` WorkspaceWebhookResponseModel[], required — List of webhooks currently configured for the workspace
    - `name` string, required — The display name for this webhook.
    - `webhook_id` string, required — The unique ID for this webhook.
    - `webhook_url` string, required — The HTTPS callback URL that is called when this webhook is triggered in the platform.
    - `is_disabled` boolean, required — Whether the webhook has been manually disabled by a user.
    - `is_auto_disabled` boolean, required — Whether the webhook has been automatically disabled due to repeated consecutive failures over a long period of time.
    - `created_at_unix` integer, required — Original creation time of the webhook.
    - `auth_type` 'hmac' | 'oauth2' | 'mtls', required
    - `usage` WorkspaceWebhookUsageResponseModel[], nullable — The list of products that are currently configured to trigger this webhook.
      - `usage_type` 'ConvAI Agent Settings' | 'ConvAI Settings' | 'Voice Library Removal Notices' | 'Speech to Text' | 'Agent QA Evaluations' | 'ConvAI Alerting' | 'Flows' | 'Dubbing', required
    - `events` WorkspaceWebhookEventType[], nullable — The workspace-level events this webhook is currently subscribed to. Only populated when usages are requested.
    - `most_recent_failure_error_code` integer, nullable — The most recent error code returned from the callback URL.
    - `most_recent_failure_timestamp` integer, nullable — The most recent time the webhook failed, failures are any non-200 codes returned by the callback URL.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/revisions/e77a0a530a82/schema)