---
title: "Get a webhook"
method: GET
path: "/v2/webhooks/{webhook_id}"
tags: ["Webhooks"]
---

# Get a webhook

`GET /v2/webhooks/{webhook_id}`

Get a single webhook.

Required scopes: `webhook:read`.

## Path parameters

- `webhook_id` string, uuid, required — A UUID which identifies the webhook.

## Response `200`

Success

- object — Success
  - `data` object, required
    - `target_url` string, uri, required — URL where the webhook events will be delivered to.
    - `subscriptions` object[], required — One or more events the webhook is subscribed to. Within a workspace, the combination of target URL, event type and filter must be unique across all of your webhooks. A duplicate — whether against another webhook or repeated within a single request — is rejected with a `409 uniqueness_conflict`.
      - `event_type` 'call-recording.created' | 'comment.created' | 'comment.resolved' | 'comment.unresolved' | 'comment.deleted' | 'list.created' | 'list.updated' | 'list.deleted' | 'list-attribute.created' | 'list-attribute.updated' | 'list-entry.created' | 'list-entry.updated' | 'list-entry.deleted' | 'object-attribute.created' | 'object-attribute.updated' | 'note.created' | 'note-content.updated' | 'note.updated' | 'note.deleted' | 'record.created' | 'record.merged' | 'record.updated' | 'record.deleted' | 'task.created' | 'task.updated' | 'task.deleted' | 'workspace-member.created', required — Type of event the webhook is subscribed to.
      - `filter` union, required — Filters to determine whether the webhook event should be sent. If null, the filter always passes. When filters are compared for uniqueness, key order and the order of operations are ignored.
        - object
          - `$or` union[], required
            - union
              - …
        - object
          - `$and` union[], required
            - union
              - …
    - `id` object, required
      - `workspace_id` string, uuid, required — The ID of the workspace the webhook belongs to.
      - `webhook_id` string, uuid, required — The ID of the webhook.
    - `status` 'active' | 'degraded' | 'inactive', required — The state of the webhook. Webhooks marked as active and degraded will receive events, inactive ones will not. If a webhook remains in the degraded state for 7 days, it will be marked inactive.
    - `created_at` string, required — When the webhook was created.

## Other responses

- `404` — Not Found

---

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