ENSign In
Referencia APIv1Webhooks

Create a webhook

Register a new webhook endpoint. The secret is returned ONLY in this response.

POST
/v1/webhooks

Authorization

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"
      }
    ]
  }
}