Test Webhook
Webhooks
Test Webhook
Fire a test webhook to verify your endpoint is reachable. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON request/response, full schema and.
POST
Test Webhook
Send a real signed test webhook to your endpoint. Use this to verify your endpoint is reachable, responding with
2xx, and correctly validating the X-Tuco-Signature header.
The test payload includes data.test: true so your handler can distinguish health checks from real events.
Authentication
Path parameters
string
required
Webhook ID.
What gets sent to your endpoint
Tuco sends a realPOST to your webhook URL with:
Test payload your endpoint receives
The signature is real — computed with your webhook’s secret using the same HMAC-SHA256 algorithm as production webhooks. This means your signature verification code gets tested too.
Response
boolean
Whether your endpoint responded with 2xx
string
Human-readable result (on success)
number
HTTP status code from your endpoint
string
Response body from your endpoint
string
Error message (on failure)
string
Error details (on failure)