Releasesv0.1.0
Api referenceEndpointsWebhooks

Send a test event

POST
/v1/webhooks/{webhook_id}/test

Queues a test event for this endpoint alone, whatever its event types. Without a body (or with event_type webhook.test) it is the generic webhook.test event. With another event_type it is a realistic sample of that event, about no real user (user_id is the nil UUID, external_ref is sample-user). Either payload carries "test": true.

Authorization

tenantKey
headerAuthorizationBearer <token>

Tenant API key, ohs_sk_ + 43 base62 characters.

Path Parameters

webhook_id*string
Formatuuid

Header Parameters

Authorization*string

The tenant API key, as a bearer secret.

Request Body

application/json
  1. body
event_type?|

The event to send a sample of. Absent means webhook.test.

Response Body

Queued.

application/json
  1. response
id*integer
event_id*string

The webhook-id header and the payload's id.

Formatuuid
event_type*string
status*string

parked after 8 failed attempts (about 28 hours), or when the endpoint was disabled.

Value in"pending""running""done""parked"
attempts*integer
last_status_code*integer|null
last_error*string|null
next_attempt_at*|
Formatdate-time
created_at*string
Formatdate-time
delivered_at*|
Formatdate-time
replay_of*|

The delivery this one replays (same event and payload); null for an original.

curl -X POST 'http://localhost:8080/v1/webhooks/497f6eca-6276-4993-bfeb-53cbbbba6f08/test' \  -H 'Authorization: Bearer ohs_sk_...' \  -H 'Content-Type: application/json' \  -d '{}'
{  "id": 0,  "event_id": "a7a26ff2-e851-45b6-9634-d595f45458b7",  "event_type": "string",  "status": "pending",  "attempts": 0,  "last_status_code": 0,  "last_error": "string",  "next_attempt_at": "2019-08-24T14:15:22Z",  "created_at": "2019-08-24T14:15:22Z",  "delivered_at": "2019-08-24T14:15:22Z",  "replay_of": 0}
Edit on GitHub