List webhook subscriptions
BuildingIn development for the v1 API. The contract is set; the route is not served yet.
Every subscription of the company, most recent first, without secret.
Needs the webhooks:read scope.
oauth2 webhooks:readAuthorizationBearer <token>OAuth 2.0 client credentials. Exchange your client_id and client_secret at /oauth/token of the environment for a bearer token valid for one hour. The playground of every operation asks for your own client and keeps it in your browser tab only.
Scope: webhooks:read
cursor?stringFrom next_cursor of the previous page.
limit?integer1 to 100.
1 <= value <= 10020OK
application/json- response
data*array<>next_cursor*|nullcurl -X GET 'https://api.dev.b2b.heru.app/v1/webhooks'{ "data": [ { "id": "whk_01m53g5zw414zt6vg08fqbacgm", "url": "https://partner.example.com/heru/webhooks", "description": "POS production", "event_types": [ "invoice.stamped", "charge.invoiced" ], "merchant_ids": [ "mer_01m4ra8wsyfh3s0tr4nrq3y96j" ], "status": "active", "disabled_reason": null, "disabled_at": null, "headers": [ { "name": "X-Partner-Token", "value": "****abcd" } ], "secret_last4": "L2Do", "secret_rotating_until": null, "consecutive_failures": 0, "failing_since": null, "environment": "production", "created_at": "2026-10-25T12:00:00.000Z", "updated_at": "2026-10-25T12:00:00.000Z", "deliveries": { "path": "/v1/webhooks/whk_01m53g5zw414zt6vg08fqbacgm/deliveries" } }, { "id": "whk_01m53gq8hyf2nx7r0vcm4t9akd", "url": "https://old.partner.example.com/heru", "description": "Legacy endpoint", "event_types": [ "*" ], "merchant_ids": [], "status": "disabled", "disabled_reason": "endpoint_gone", "disabled_at": "2026-10-24T08:30:12.000Z", "headers": [], "secret_last4": "Q2hz", "secret_rotating_until": null, "consecutive_failures": 1, "failing_since": "2026-10-24T08:30:12.000Z", "environment": "production", "created_at": "2026-09-01T10:00:00.000Z", "updated_at": "2026-10-24T08:30:12.000Z", "deliveries": { "path": "/v1/webhooks/whk_01m53gq8hyf2nx7r0vcm4t9akd/deliveries" } } ], "next_cursor": null}Delete a webhook subscriptionDEL
Stops every delivery to it: the deliveries still waiting to be sent expire. The delivery log stays readable for 30 days. Needs the `webhooks:write` scope.
Get a webhook subscriptionGET
Returns the subscription without `secret`; `secret_last4` tells which secret signs and `secret_rotating_until` whether a previous one still does. Needs the `webhooks:read` scope.