List webhooks

curl --request GET \
  --url https://api.managem.co.uk/seller/webhooks \
  --header 'Authorization: Bearer <token>'

{
  "webhooks": [
    {
      "id": "<string>",
      "url": "<string>",
      "enabled": true,
      "additionalHeaders": {},
      "secret": "<string>",
      "lastSuccessAt": "2023-11-07T05:31:56Z",
      "lastFailureAt": "2023-11-07T05:31:56Z",
      "consecutiveFailures": 123,
      "maxConsecutiveFailures": 123,
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "subscriptions": [],
      "description": "<string>"
    }
  ]
}

Management

List webhooks

Retrieve all webhook endpoints configured for the authenticated seller.

Use this endpoint to build a webhook management screen or to reconcile expected webhook configuration during deployments.

The response includes per-endpoint configuration and health indicators, including:

URL and optional description.
Enabled/disabled status.
Additional headers currently configured.
Secret value used by your receiver-side verification logic.
Last success/failure timestamps.
Consecutive failure counters and subscription events.

Operational guidance:

Call this endpoint after create, update, subscription changes, or delete operations.
Use ‘enabled’ plus failure counters to detect endpoints that require attention.
Persist webhook ids from this response for follow-up operations such as test, update, or failure inspection.

GET

seller

webhooks

List webhooks

curl --request GET \
  --url https://api.managem.co.uk/seller/webhooks \
  --header 'Authorization: Bearer <token>'

{
  "webhooks": [
    {
      "id": "<string>",
      "url": "<string>",
      "enabled": true,
      "additionalHeaders": {},
      "secret": "<string>",
      "lastSuccessAt": "2023-11-07T05:31:56Z",
      "lastFailureAt": "2023-11-07T05:31:56Z",
      "consecutiveFailures": 123,
      "maxConsecutiveFailures": 123,
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "subscriptions": [],
      "description": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Seller webhook endpoints

Response containing a list of the seller's webhook endpoints.

webhooks

Seller Webhook Endpoint · object[]

required

Collection of webhook endpoints owned by the seller

Show child attributes

Get delivery metrics Create webhook