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

# List Webhooks

> List the webhook endpoints of your workspaces

## List Webhooks

Returns the webhook endpoints of the workspaces your key can reach. The signing secret is never included; each endpoint shows `secret_last4`.

### Request

**workspace\_id** `integer`

Only list endpoints of this workspace

```bash theme={null}
curl -X GET "https://postsyncer.com/api/v1/webhooks" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

### Response

An array of endpoint objects.

**id** `integer`

Unique identifier of the endpoint

**name** `string`

Display name of the endpoint

**url** `string`

The https address that receives the events. An address can carry a token, so it is shown in full only when the key's owner may edit the endpoint (`notifications` edit in its workspace, and in every workspace it covers). Otherwise it is cut to the scheme and host, such as `https://example.com/…`.

**url\_masked** `boolean`

`true` when `url` was cut because the key's owner may not edit the endpoint

**secret\_last4** `string`

The last four characters of the signing secret. The API returns the full secret only when you create the endpoint; the app can show it again.

**events** `array`

Event keys the endpoint gets

**account\_ids** `array`

Social account ids the endpoint is limited to, or `null` for all accounts

**workspace\_ids** `array`

Other workspaces whose events it also gets (`["*"]` for every workspace the creator owns), or `null`

**active** `boolean`

Whether the endpoint is on. PostSyncer turns an endpoint off after it has been failing for 3 days.

**failing\_since** `string`

When the endpoint started failing, or `null`

**disabled\_reason** `string`

Why PostSyncer turned the endpoint off, or `null`

**stats\_7d** `object`

Deliveries over the last 7 days: `sent`, `failed` and `daily`, seven entries with the oldest first

**last\_delivery\_at** `string`

When the latest delivery was made, or `null`

```json theme={null}
[
{
  "id": 42,
  "workspace_id": 12,
  "kind": "webhook",
  "name": "Ops alerts",
  "url": "https://example.com/postsyncer-hook",
  "url_masked": false,
  "secret_last4": "k3Jx",
  "events": ["post.failed", "post.published"],
  "account_ids": null,
  "workspace_ids": null,
  "active": true,
  "failing_since": null,
  "disabled_reason": null,
  "created_at": "2026-11-15T09:30:00+00:00",
  "updated_at": "2026-11-15T09:30:00+00:00",
  "stats_7d": {
    "sent": 18,
    "failed": 1,
    "daily": [
      { "date": "2026-11-09", "sent": 0, "failed": 0 },
      { "date": "2026-11-10", "sent": 3, "failed": 0 },
      { "date": "2026-11-11", "sent": 2, "failed": 1 },
      { "date": "2026-11-12", "sent": 4, "failed": 0 },
      { "date": "2026-11-13", "sent": 3, "failed": 0 },
      { "date": "2026-11-14", "sent": 5, "failed": 0 },
      { "date": "2026-11-15", "sent": 1, "failed": 0 }
    ]
  },
  "last_delivery_at": "2026-11-15T09:12:44+00:00"
}
]
```

Needs the `webhooks:read` permission.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.