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

# List Webhooks

> List all webhooks configured for the current workspace.

## Authentication

Requires an API key in the `Authorization` header.

```bash theme={"dark"}
Authorization: Bearer YOUR_API_KEY
```

## Request

No parameters required. Returns all webhooks for the authenticated user's current workspace.

### Example request

```bash theme={"dark"}
curl https://encrata.com/api/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response

Returns an array of webhook objects.

<ResponseField name="id" type="string">
  Unique webhook identifier (UUID).
</ResponseField>

<ResponseField name="workspace_id" type="string">
  The workspace this webhook belongs to.
</ResponseField>

<ResponseField name="url" type="string">
  The HTTPS URL that receives webhook deliveries.
</ResponseField>

<ResponseField name="events" type="string[]">
  List of event types this webhook is subscribed to.
</ResponseField>

<ResponseField name="is_active" type="boolean">
  Whether the webhook is currently active.
</ResponseField>

<ResponseField name="description" type="string">
  Optional description of the webhook.
</ResponseField>

<ResponseField name="created_by" type="string">
  User ID of the webhook creator.
</ResponseField>

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

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

### Example response

```json theme={"dark"}
[
  {
    "id": "360cb300-d885-4c18-af2c-d259f936bb38",
    "workspace_id": "51cdc9d9-203c-4345-b06d-222b560460aa",
    "url": "https://example.com/webhook",
    "events": ["lookup.completed", "apikey.created"],
    "is_active": true,
    "description": "Production webhook",
    "created_by": "e861d7cb-1d7f-48d9-ab13-9af06a4055cf",
    "created_at": "2026-05-02T12:00:00Z",
    "updated_at": "2026-05-02T12:00:00Z"
  }
]
```