- Home
- API reference
- Webhooks
- Send a test event
Send a test event
Sends a test event to check that the endpoint can receive webhook requests.
POST
/v1/webhook-endpoints/{id}/testRequires
webhooks:write permission.Path parameters
Section titled “Path parameters”idstringrequiredThe id of the endpoint (whk_…).
Example: whk_01k7q3m8x2v5t9n4b6c1d0e7fa
Prefixed with whk_.
Request body
Section titled “Request body”project_idstringoptionalProject to use for the test event. Required for a merchant-level endpoint; a project endpoint uses its configured project.
Example: prj_01k7q3m8x2v5t9n4b6c1d0e7fa
Prefixed with prj_.
Response (200)
Section titled “Response (200)”dataobjectrequiredThe returned object, or an array of objects for a list.
event_idstringrequiredThe id of the test event that was queued.
Example: wev_01k7q3m8x2v5t9n4b6c1d0e7fa
Prefixed with wev_.
metaobjectrequiredRequest details such as its id and pagination cursor.
request_idstringrequiredThe id of this request. Quote it when you ask support about it.
Example: req_Hy3k9QzT2LmN8vXa
A failed request answers with the common error shape; see Errors.