Skip to main content
The List Webhooks endpoint returns every webhook you have registered under your merchant account. Each object in the response includes delivery statistics — successful and failed counts — so you can quickly assess the health of your webhook integrations at a glance. This endpoint requires the webhooks:read permission.

​
Request

GET https://0k90mc4jjj.execute-api.us-east-2.amazonaws.com/v1/webhooks

​
Headers

​
Authorization
string
required
Bearer token using your API key. Format: Bearer cs_live_your_key

​
Response

​
200 — success

​
webhooks
array
List of registered webhook objects.
​
count
integer
Total number of webhooks returned in this response.

​
401 — unauthorized

Returned when your API key is missing, invalid, or does not have the webhooks:read permission.

​
Example

curl https://0k90mc4jjj.execute-api.us-east-2.amazonaws.com/v1/webhooks \
  -H "Authorization: Bearer cs_live_your_key"
Sample response
{
  "webhooks": [
    {
      "webhookId": "wh_01hx4kz9mntd8vr2bpqe5ycf3a",
      "url": "https://yourapp.com/webhooks/charitystack",
      "events": [
        "donation.created",
        "subscription.created",
        "subscription.cancelled"
      ],
      "status": "ACTIVE",
      "description": "Production webhook for donation notifications",
      "createdAt": 1714003200,
      "lastDeliveryAt": 1714089600,
      "successCount": 142,
      "failureCount": 3
    },
    {
      "webhookId": "wh_02jy5la0noue9ws3cqrf6zdg4b",
      "url": "https://yourapp.com/webhooks/contacts",
      "events": [
        "contact.created",
        "contact.updated"
      ],
      "status": "DISABLED",
      "description": "Contact sync — temporarily disabled",
      "createdAt": 1712800000,
      "lastDeliveryAt": 1713600000,
      "successCount": 57,
      "failureCount": 0
    }
  ],
  "count": 2
}