# webhooks.endpoints.list

List outgoing webhook endpoints with their subscribed events, status, recent delivery counts, and the last four characters of each signing secret.

`GET | POST /api/v1/accounting/webhooks.endpoints.list`

Permissions: `accounting:read`, `accounting:admin` · Roles: admin

MCP tool: `accounting_webhooks_endpoints_list`

## Fields

This action takes no input fields. Send `{}`.

## Example request

```bash
curl https://app.getoatmilk.com/api/v1/accounting/webhooks.endpoints.list \
  -H "Authorization: Bearer $OATMILK_API_KEY"
```

## Example response

```json
{
  "data": {
    "items": [
      {
        "id": "5d4c3b2a-1f0e-4d9c-8b7a-6e5f4d3c2b1a",
        "url": "https://example.com/webhooks/oatmilk",
        "description": "CRM sync",
        "events": [
          "invoice.*"
        ],
        "secret_hint": "a1B2",
        "secret_version": 1,
        "active": true,
        "failure_count": 0,
        "disabled_reason": null,
        "disabled_at": null,
        "last_delivery_at": null,
        "last_success_at": null,
        "created_by": "user_synthetic",
        "archived_at": null,
        "revision": 1,
        "created_at": "2026-09-30T14:00:00Z",
        "updated_at": "2026-09-30T14:00:00Z",
        "status": "active",
        "recent": {
          "delivered": 42,
          "failed": 1,
          "pending": 0
        }
      }
    ],
    "signingReady": true
  }
}
```

Reference page: https://app.getoatmilk.com/docs/api/webhooks.endpoints.list