Skip to main content
GET
/
v1
/
webhooks
List Webhooks
curl --request GET \
  --url https://api.example.com/v1/webhooks

​
List Webhooks

Retrieve a list of all webhooks in your account.
​
limit
integer
default:"10"
Number of webhooks to return. Maximum 100.
​
starting_after
string
Cursor for pagination.
​
status
string
Filter by status: active, failing, disabled.

​
Request

curl "https://api.lettr.dev/v1/webhooks" \
  -H "Authorization: Bearer le_xxxxxxxxxxxx"

​
Response

{
  "object": "list",
  "data": [
    {
      "id": "wh_123abc",
      "object": "webhook",
      "url": "https://example.com/webhooks/lettr",
      "events": ["email.delivered", "email.bounced"],
      "status": "active",
      "lastDeliveryAt": "2024-01-15T14:30:00Z",
      "createdAt": "2024-01-15T10:30:00Z"
    },
    {
      "id": "wh_456def",
      "object": "webhook",
      "url": "https://backup.example.com/webhooks",
      "events": ["*"],
      "status": "active",
      "lastDeliveryAt": "2024-01-15T14:30:00Z",
      "createdAt": "2024-01-10T08:00:00Z"
    }
  ],
  "hasMore": false,
  "totalCount": 2
}