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

# List Webhook Endpoints

> List the account's webhook endpoints and the event types they can subscribe to.

Returns all webhook endpoints on the account, plus `supportedEvents` — the full set of event types an endpoint may subscribe to. Signing secrets are not included (they're only returned on [create](/api-reference/v2/webhooks/create-endpoint) and [rotate](/api-reference/v2/webhooks/rotate-secret)).

## Examples

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.tracklysms.com/api/v2/webhooks \
    -H "X-Api-Key: trk_your_api_key"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 — Success theme={null}
  {
    "webhooks": [
      {
        "id": "66b0f7c84a1d4b2e9c3a1f2e",
        "accountId": 1042,
        "url": "https://hooks.bizinga.com/trackly",
        "events": ["message.delivered", "message.failed"],
        "active": true,
        "signingSecretRotatedAt": null,
        "createdAt": "2026-07-26T14:03:11Z",
        "updatedAt": "2026-07-26T14:03:11Z"
      }
    ],
    "supportedEvents": [
      "message.delivered", "message.failed", "message.reply", "contact.opted_out",
      "business_profile.verified", "business_profile.rejected",
      "business_profile.name_confirm_required", "business_profile.review_required"
    ]
  }
  ```
</ResponseExample>

## Next Steps

<CardGroup cols={2}>
  <Card title="Create an endpoint" icon="plus" href="/api-reference/v2/webhooks/create-endpoint">
    Register a new HTTPS endpoint.
  </Card>

  <Card title="Deliveries" icon="rotate-right" href="/api-reference/v2/webhooks/list-deliveries">
    Inspect an endpoint's delivery log.
  </Card>
</CardGroup>
