Skip to main content
GET
/
api
/
webhooks
/
subscriptions
List subscriptions
curl --request GET \
  --url https://api.example.com/api/webhooks/subscriptions \
  --header 'Authorization: <authorization>'
[
  {
    "id": "1c84203c-b4e3-40de-83a9-51bc0d9c991f",
    "url": "https://hooks.example.com/teel",
    "events": ["payout.created", "payout.status.updated"],
    "status": "active",
    "secretPrefix": "whsec_Pdt_BP",
    "label": "Production receiver",
    "lastSuccessAt": "2026-05-27T09:31:02Z",
    "lastFailureAt": null,
    "createdAt": "2026-05-27T09:30:00Z",
    "updatedAt": "2026-05-27T09:30:00Z"
  }
]
All subscriptions on your account.

​
Account limits

LimitValue
Subscriptions per account25
Maximum payload size (JSON envelope)256 KB
URL schemehttps:// only
Loopback, RFC1918 private, link-local, and known cloud metadata host/IP ranges are rejected at create time and at delivery time (DNS is re-resolved before every POST).
Scope webhooks:read

​
Headers

​
Authorization
string
required
API key.

​
Response

​
id
string
Subscription UUID.
​
url
string
The delivery URL.
​
events
string[]
Event types the subscription listens for (e.g. payout.created, payout.status.updated).
​
status
string
active or paused.
​
secretPrefix
string
First few characters of the signing secret, for partner-side identification. The plaintext is only ever returned by Create and Rotate.
​
label
string
Human-readable label shown in the dashboard. Never sent to your endpoint.
​
lastSuccessAt
string
ISO 8601 timestamp of the most recent 2xx delivery. null if none yet.
​
lastFailureAt
string
ISO 8601 timestamp of the most recent failed delivery. null if none yet.
​
createdAt
string
ISO 8601 timestamp.
​
updatedAt
string
ISO 8601 timestamp.
[
  {
    "id": "1c84203c-b4e3-40de-83a9-51bc0d9c991f",
    "url": "https://hooks.example.com/teel",
    "events": ["payout.created", "payout.status.updated"],
    "status": "active",
    "secretPrefix": "whsec_Pdt_BP",
    "label": "Production receiver",
    "lastSuccessAt": "2026-05-27T09:31:02Z",
    "lastFailureAt": null,
    "createdAt": "2026-05-27T09:30:00Z",
    "updatedAt": "2026-05-27T09:30:00Z"
  }
]