> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trypost.it/llms.txt
> Use this file to discover all available pages before exploring further.

# List webhooks

> List outgoing webhooks for the current workspace, newest first. Returns a plain array (no pagination).

Requires **manage webhooks** permission (Owner / Admin). Members and Viewers get `403`.

Signing secrets are omitted. Use [`GET /webhooks/{webhook}`](/api-reference/endpoint/get-webhook) to read a secret.

## Response

Plain array of webhook objects.

<ResponseField name="id" type="string">
  Webhook UUID.
</ResponseField>

<ResponseField name="endpoint" type="string">
  Public URL that receives signed POSTs.
</ResponseField>

<ResponseField name="events" type="array">
  Subscribed event names. One or more of `post.created`, `post.scheduled`, `post.unscheduled`, `post.published`, `post.partially_published`, `post.failed`, `post.deleted`. There is no `publishing` event.
</ResponseField>

<ResponseField name="status" type="string">
  `enabled`, `disabled`, or `paused`.
</ResponseField>

<ResponseField name="last_sent_at" type="string">
  ISO 8601 timestamp of the last successful delivery. `null` if none.
</ResponseField>

<ResponseField name="paused_at" type="string">
  ISO 8601 timestamp when TryPost last paused the webhook. `null` until the first pause, and cleared when you set `status` back to `enabled`. Disabling a paused webhook leaves this value set.
</ResponseField>

<ResponseField name="consecutive_failures" type="integer">
  Failed deliveries since the last success. Pauses at `5`.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 creation timestamp.
</ResponseField>

<ResponseField name="updated_at" type="string">
  ISO 8601 last-update timestamp.
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl -X GET https://app.trypost.it/api/webhooks \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "endpoint": "https://example.com/webhooks/trypost",
      "events": ["post.published", "post.failed"],
      "status": "enabled",
      "last_sent_at": "2026-09-04T15:04:05+00:00",
      "paused_at": null,
      "consecutive_failures": 0,
      "created_at": "2026-09-01T12:00:00+00:00",
      "updated_at": "2026-09-04T15:04:05+00:00"
    }
  ]
  ```
</ResponseExample>