Webhooks

Get webhook details

Retrieve a specific webhook by its ID, including its subscribed event types.

Authorization

Public key
x-fngs-public-key<token>

In: header

Path Parameters

webhookId*string

Unique identifier (UUID) of the webhook.

Formatuuid

Response Body

application/json

application/json

GET
/v0/webhooks/{webhookId}
curl -X GET "https://example.com/v0/webhooks/550e8400-e29b-41d4-a716-446655440000"
{  "status": "success",  "data": {    "webhook": {      "object": "webhook",      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "url": "string",      "status": "active",      "secret": "string",      "events": [        "payment_success"      ],      "lastBlockReason": "malformed_url",      "lastBlockedAt": null,      "consecutiveFailures": 0,      "failingSince": null,      "createdAt": 0,      "deletedAt": null    }  }}

Send a test event POST

Fire a synthetic event of the given type. It is delivered to every active webhook currently subscribed to that event type — not just one — the same way a real event would be, including retries on failure. Useful for verifying a receiving endpoint without a real purchase. `items` and `userId` are hints: the synthetic payload does not always carry them. When a subscribed endpoint refuses the delivery, the call answers an error instead of `{ success: true }`.

Update a webhook PATCH

Update a webhook's URL, status, secret, or subscribed events. Any field omitted from the request is left unchanged. Passing 'events' replaces the full set of subscribed event types.