API DocumentationWebhooks

Create a webhook

POST
/api/manufacturer/v1/webhook

Creates a webhook for one event type on the authenticated account. The URL must use HTTPS and resolve to a public address. Save the returned id for deletion and secret for decrypting deliveries. Deliveries contain a JSON payload field encrypted with AES-256-GCM and an X-Phasio-Signature HMAC-SHA256 header.

Authorization

Phasio API Bearer Token
AuthorizationBearer <token>

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://example.com/api/manufacturer/v1/webhook" \  -H "Content-Type: application/json" \  -d '{    "url": "string",    "type": "ORDER"  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "url": "string",  "type": "string",  "secret": "string"}
{  "error": "ORDER_NOT_FOUND",  "message": "Order not found"}