Webhooks

Send Test Event

Sends a sample payload for the given event to the webhook's URL and returns the delivery result.

post/webhooks/{id}/test

Headers

Idempotency-Keystring
Example:d9105228-4a08-46b1-8b91-42fed586d383

A unique key that makes this request safe to retry. See Idempotent requests.

Request body

eventstring required

The event to test the webhook for, in dot form (for example payment.succeeded).

Example request

{
  "event": "payment.succeeded"
}

Response

test event sent

bodystring required

The body of the webhook response.

statusinteger required

The HTTP response code of this request.

successboolean required

Whether or not the webhook test was successful.

Example response

{
  "body": "OK",
  "status": 200,
  "success": true
}

Changes

Changed in 3 of the 74 revisions of this API.6

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ○

      endpoint added

      endpoint-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 74 revisions, 1 has no diff computed.