# listWebhookEndpoints

> Part of the MAP Audio Music API docs. Index of every page: https://map.audio/developers/music-api/llms.txt. OpenAPI document: https://map.audio/developers/music-api/openapi.json.

`GET https://api.map.audio/v1/webhook-endpoints`

List webhook endpoints

The account's webhook endpoints, newest first, without their secrets. Free.

Auth: `Authorization: Bearer` with an API key or a map.audio access token. Not an MCP tool: Webhook endpoints hold signing secrets for your own server; set them up with an API key (POST /v1/webhook-endpoints) or with the account holder's map.audio sign-in.

## Example

```sh
curl -sS "https://api.map.audio/v1/webhook-endpoints" \
  -H "Authorization: Bearer $MAP_API_KEY" \
  -H "Map-Version: 2026-11-01"
```

### 200: One endpoint

```json
{
  "object": "list",
  "data": [
    {
      "object": "webhook_endpoint",
      "id": "whep_01M6BPRWZCT8J4PSWZ8KG7EXWV",
      "url": "https://hooks.example.com/map-audio",
      "events": [
        "job.succeeded",
        "job.failed"
      ],
      "description": "Render notifications",
      "status": "enabled",
      "createdAt": "2026-11-01T13:58:02.418Z"
    }
  ]
}
```

### 400: Invalid request

```json
{
  "error": {
    "type": "invalid_request",
    "code": "invalid_request",
    "message": "\"limit\" is not a parameter of GET /v1/webhook-endpoints; it takes none.",
    "param": "limit",
    "retryable": false,
    "jobId": null,
    "docUrl": "https://map.audio/developers/music-api/errors#invalid_request",
    "requestId": "9a3f7c2e5b1d8f40-LHR"
  }
}
```

## Responses

- `200`: Endpoints.
- `400`: Invalid request
- `default`: Any other error: `error.code` names it, `error.param` the field at fault, and `error.docUrl` its entry in the error catalogue.

## Errors

- [`invalid_request`](https://map.audio/developers/music-api/errors#invalid_request)