Reference
Method: GET Path: /public/v1/orgs/:orgId/entities/:entityId/webhooks Auth: Bearer marketplace token Tenant guard: enforced Required scope: none beyond a valid install Filter: returns only IsActive: true rows. Soft-deleted subscriptions are excluded.
Response
{
"subscriptions": [
{
"_id": "65f1aa...",
"Topics": ["invoice.paid", "bill.created"],
"TargetUrl": "https://your-app.example.com/hellobooks/webhook",
"IsActive": true,
"LastDeliveryAt": "2026-05-04T10:18:11.420Z",
"LastDeliveryStatus": 200,
"ConsecutiveFailures": 0,
"createdAt": "2026-05-04T10:14:32.123Z"
}
]
}| Field | Type | Notes | |
|---|---|---|---|
_id | string | Subscription ID — use as :id in DELETE | |
Topics | string[] | Subscribed topics (already lowercased) | |
TargetUrl | string | Where deliveries are sent | |
IsActive | boolean | Always true in this response | |
LastDeliveryAt | string \ | null | ISO timestamp of last attempt |
LastDeliveryStatus | number \ | null | HTTP status of last attempt |
ConsecutiveFailures | number | Resets to 0 on any successful (2xx) delivery | |
createdAt | string | ISO timestamp |
Curl example
curl -s -H "Authorization: Bearer $HB_TOKEN" \
https://api.hellobooks.com/public/v1/orgs/$HB_ORG/entities/$HB_ENT/webhooks | jq