API Referencev1Webhooks
Create a webhook
Register a new webhook endpoint. The secret is returned ONLY in this response.
X-API-Key<token>
Per-store API key created in the dashboard at Settings > Developer > API Keys.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://api.whatalo.com/v1/webhooks" \ -H "Content-Type: application/json" \ -d '{ "url": "https://myapp.com/webhooks", "events": [ "order.created" ] }'{
"data": {
"id": "wh_abc123",
"url": "https://myapp.com/webhooks",
"events": [
"order.created",
"order.updated"
],
"is_active": true,
"last_triggered_at": "string",
"failure_count": 0,
"created_at": "string",
"updated_at": "string",
"secret": "whsec_..."
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request body",
"details": [
{
"field": "string",
"message": "string"
}
]
}
}