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

# List Webhooks

> Get all configured webhooks

## Response

<ResponseField name="webhooks" type="array">
  <Expandable title="webhook object">
    <ResponseField name="id" type="string">
      Webhook ID
    </ResponseField>

    <ResponseField name="name" type="string">
      Webhook name
    </ResponseField>

    <ResponseField name="url" type="string">
      Endpoint URL
    </ResponseField>

    <ResponseField name="events" type="array">
      Subscribed events
    </ResponseField>

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

    <ResponseField name="headers" type="object">
      Custom headers included with webhook requests
    </ResponseField>

    <ResponseField name="secret" type="string">
      Signing secret for HMAC verification
    </ResponseField>

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

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://kodostatus.com/api/v1/webhooks" \
    -H "X-API-Key: your_api_key"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "webhooks": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Incident Webhook",
        "url": "https://example.com/webhook",
        "events": ["incident.created", "incident.resolved"],
        "is_active": true,
        "headers": {},
        "secret": "whsec_...",
        "created_at": "2026-01-15T10:30:00.000Z",
        "updated_at": "2026-01-15T10:30:00.000Z"
      }
    ]
  }
  ```
</ResponseExample>