Test Webhook
POST/b2b/webhooks/:webhook_id/test
Send a test event to verify your webhook configuration.
This endpoint sends a test event to your configured webhook URL, allowing you to verify that:
- Your endpoint is reachable
- Your signature verification is working correctly
- Your endpoint responds appropriately
The test event will include a real HMAC signature that you can verify using your webhook secret.
Test Event Payload
The test event has the following structure:
{
"event_type": "webhook.test",
"message": "This is a test webhook event to verify your endpoint configuration."
}
Error Handling
| Error Type | Message | When |
|---|---|---|
Webhook not found | The webhook ID doesn't exist or belongs to a different domain | |
Webhook is disabled | The webhook exists but is not enabled (enabled: false) |
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 408
- 409
- 429
- 500
- 503
Test webhook sent (check result for delivery status)
Bad Request — the request was malformed or contained invalid parameters. Not retryable.
Unauthorized — authentication failed or credentials are missing/invalid. Not retryable.
Forbidden. Error codes:
ENexus:Webhook is disabled— not retryable
Not Found. Error codes:
ENexus:Webhook not found— not retryable
Request Timeout — the request took too long to process. Retryable.
Conflict — the request conflicts with the current state of the resource. Retryable in some cases (see error code).
Too Many Requests — rate limit exceeded. Retryable with backoff.
Internal Server Error — an unexpected error occurred. Generally retryable.
Service Unavailable — the service is temporarily unavailable. Retryable.