Download OpenAPI specification:
Accepts a webhook delivery request. The service will persist the delivery to the database, then asynchronously call the customer's webhook URL via HTTPS POST with an HMAC-SHA256 signature.
The response is 201 with no body — the delivery is queued and will be attempted asynchronously.
Use the GET /deliveries/{uuid} endpoint to check the delivery status.
| url required | string <uri> The customer's webhook URL. Must be HTTPS. |
| event_type required | string The type of event that triggered the webhook. |
required | object The JSON payload to send to the customer's webhook endpoint. |
| secret required | string The HMAC secret used to sign the webhook payload. The signature is sent in the |
{- "event_type": "vm.provisioned",
- "payload": {
- "id": "123456789",
- "label": "my-server",
- "main_ip": "1.2.3.4",
- "status": "active"
}, - "secret": "whsec_abc123"
}Retrieve the status of a webhook delivery by its UUID.
| uuid required | string <uuid> The UUID of the webhook delivery. |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "url": "string",
- "event_type": "string",
- "payload": { },
- "status": "pending",
- "retry_count": 0,
- "last_error": "string",
- "created_at": "string",
- "updated_at": "string"
}