Skip to main content
Webhooks

Send a Webhook test event

Send a test event to an Endpoint to verify its receiver URL and signature handling.

Webhook is currently in Beta. APIs, fields, and behavior may change in future versions.
POST /api/v1/forward/webhook/endpoints/{endpoint_id}/test The test event type is webhook.test and does not need to be included in the Endpoint subscription list. Delivery is asynchronous. A successful API response means the test event was accepted, not that the receiver has finished processing it. Ensure the Endpoint is enabled before calling this API. If it is disabled, the API may still return 202, but delivery_rows is 0 and no callback is sent.

Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT or administrator SAT>

Path parameters

ParameterTypeRequiredDescription
endpoint_idstringYesWebhook Endpoint ID.

Example request

curl -s -X POST 'https://api.qoder.com/api/v1/forward/webhook/endpoints/e149c233-1234-4abc-8def-1234567890ab/test' \
  -H "Authorization: Bearer $QODER_PAT"

Example response

HTTP 202 Accepted 
{
  "event_id": 433,
  "delivery_rows": 1
}

Response fields

FieldTypeDescription
event_idintegerIdentifier for this test request.
delivery_rowsintegerNumber of delivery tasks accepted for this test.
Example event received by the Endpoint: 
{
  "type": "event",
  "id": "whe_01k1jbxexample",
  "endpoint_id": "e149c233-1234-4abc-8def-1234567890ab",
  "emitted_at": "2026-09-01T09:01:22Z",
  "note": "This is a synthetic test event."
}

Errors

HTTPTypeTrigger
401authentication_errorAuthentication is missing, invalid, or expired.
403permission_errorThe current token cannot manage Webhooks.
404not_found_errorThe Endpoint does not exist or is not visible to the current account.
500/502/503api_errorThe test event cannot be sent temporarily.

Receive Webhook events

Get a Webhook Endpoint

First steps
Define your agent
Configure agent environment
Delegate work to your agent
Agent integrations
Manage agent context
Account
Best Practices
Announcements
API reference