# List Alert Webhooks

### List Webhooks

Retrieve a list of all webhook configurations registered for your customer. This endpoint returns the webhook IDs, URLs, creation timestamps, and descriptions, allowing you to identify which webhooks are configured and manage them accordingly.

#### Authentication

Include the following headers in your requests:

```
Access-Token: <your-access-token>
```

#### Permissions

Ensure your API user has a role with `external-api-get-webhook-list` permission.

#### Endpoint

* **URL**: `https://api.genlogs.io/alerts/webhook`
* **Method**: `GET`

#### Request Parameters

This endpoint does not require any query parameters or request body. The `customer_id` is automatically extracted from your access token.

#### Response Codes

| Code                        | Description                                               |
| --------------------------- | --------------------------------------------------------- |
| `200 OK`                    | Successfully retrieved the list of webhook configurations |
| `401 Unauthorized`          | Authentication credentials missing or incorrect           |
| `403 Forbidden`             | User lacks permission to list webhook configurations      |
| `500 Internal Server Error` | Server error occurred                                     |

#### Response Body

The response is an array of webhook objects. Each object contains:

| Field         | Type              | Description                                      |
| ------------- | ----------------- | ------------------------------------------------ |
| `id`          | string (UUID)     | Unique identifier for the webhook configuration  |
| `created_at`  | string (datetime) | ISO timestamp when the configuration was created |
| `webhook_url` | string            | The URL where notifications are sent             |
| `description` | string\|null      | Human-readable description for the webhook       |

**Response Example**

```json
[
  {
    "id": "0f8a681f-48ce-44f0-8e27-b8311c17b12a",
    "created_at": "2025-09-23T21:37:30.173622",
    "webhook_url": "https://example.com/webhook",
    "description": "Production webhook endpoint"
  },
  {
    "id": "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
    "created_at": "2025-09-24T10:15:00.000000",
    "webhook_url": "https://another.example.com/webhook",
    "description": "Development webhook endpoint"
  },
  {
    "id": "2b3c4d5e-6f78-9012-bcde-f12345678901",
    "created_at": "2025-09-25T14:20:15.123456",
    "webhook_url": "https://staging.example.com/webhook",
    "description": null
  },
  ...
]
```

**Empty Response**

If no webhooks are registered for your organization, the endpoint returns an empty array:

```json
[]
```

#### Request Example

```bash
curl -L \
  --request GET \
  --url 'https://api.genlogs.io/alerts/webhook' \
  --header 'Access-Token: YOUR_ACCESS_TOKEN' \
  --header 'x-api-key: YOUR_API_KEY'
```

#### Notes

* The response only includes webhooks registered for your organization (determined by the `customer_id` in your access token).
* The `secret` field is not included in the response for security reasons.
* Use the `id` field to reference specific webhooks when updating or managing them via other endpoints.
* The `created_at` timestamp helps identify when each webhook was registered.

> List all webhooks for the authenticated customer

## List Webhooks

> List all webhooks for the authenticated customer

```json
{"openapi":"3.1.0","info":{"title":"Alert API","version":"0.0.1"},"security":[{"APIKeyHeader":[]}],"components":{"securitySchemes":{"APIKeyHeader":{"type":"apiKey","description":"JWT Access Token required for authentication","in":"header","name":"Access-Token"}}},"paths":{"/alerts/webhook":{"get":{"tags":["Webhook Alerts"],"summary":"List Webhooks","description":"List all webhooks for the authenticated customer","operationId":"list_webhooks_alerts_webhook_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"type":"object"},"type":"array","title":"Response List Webhooks Alerts Webhook Get"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.genlogs.io/alert-webhook/list-alert-webhooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.