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

# List webhooks

`GET /v2/webhooks`

Get all of the webhooks in your workspace.

Required scopes: `webhook:read`.

## Query parameters

- `limit` integer — The maximum number of results to return, between 10 and 100, defaults to 10. See the [full guide to pagination here](/rest-api/guides/pagination).
- `offset` integer — The number of results to skip over before returning, defaults to 0. See the [full guide to pagination here](/rest-api/guides/pagination).

## 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.

---

[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)