Webhooks
Create webhook
Create a new webhook subscription.
X-API-Key<token>
GPU API key (format: mk_...). Generate from the dashboard
or via POST /api-keys.
In: header
Request Body
application/json
Response Body
application/json
application/json
application/json
curl -X POST "https://gpu.huddleapis.com/api/v1/webhooks" \ -H "Content-Type: application/json" \ -d '{ "url": "https://your-server.com/webhook", "events": [ "deployment.running", "deployment.error", "deployment.deleted" ] }'{
"code": "OK",
"data": {
"id": "w1x2y3z4-...",
"url": "https://your-server.com/webhook",
"secret": "whsec_a1b2c3d4e5f6...signing_secret",
"events": [
"deployment.running",
"deployment.error",
"deployment.deleted"
],
"is_active": true,
"created_at": "2026-04-01T12:30:00Z",
"updated_at": "2026-04-01T12:30:00Z"
}
}{
"code": "BAD_REQUEST",
"error": "Missing required field: hostname"
}{
"code": "BAD_REQUEST",
"error": "Missing required field: hostname"
}