BeaconBox
Esc

Type to search.

Dashboard

Test a webhook endpoint

Send one sample ping and report what came back. Answers 200 whatever your endpoint does, so read the body.

POST/api/v1/webhook-endpoints/{public_id}/test

Request

curl -X POST https://api.beaconbox.eu/api/v1/webhook-endpoints/v55favd767qu/test \
  -H "Authorization: Bearer $BEACONBOX_API_KEY"

Path parameters

NameTypeDescription
public_idstring

Response

Returns 200.

FieldTypeDescription
deliveredbooleanTrue when the endpoint answered 2xx.
status_codeinteger | nullWhat the endpoint answered. Null when it could not be reached.
errorstring | nullWhat went wrong, in words meant for the person who pressed test.
duration_msintegerHow long the endpoint took to answer.

Errors

Failures are { "error_code": "..." } with a stable dotted code. See Errors for the codes worth branching on and the three outcomes that look like failures and are not.