Create webhook
POST
/v1/api/webhooksRegisters an endpoint that receives an event whenever an agent finishes a turn in any of your workspaces. The response includes the signing secret, which is shown only once. You can register up to 20 endpoints.
Authorization
apiKey AuthorizationBearer <token>
An API key that starts with zk_. Create one in the Zuse app.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
A webhook endpoint to register.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/api/webhooks" \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com/zuse/webhooks" }'{ "webhook": { "webhookId": "wh_7Hn2kQ9xLm4", "url": "https://example.com/zuse/webhooks", "description": "Production notifier", "createdAt": 1760697600000 }, "secret": "whsec_9a8b7c6d5e4f3g2h1i0jKLMNOPQRSTUVWXYZabcdefg"}{ "error": "invalid_api_key", "detail": "string"}{ "error": "invalid_api_key", "detail": "string"}{ "error": "invalid_api_key", "detail": "string"}{ "error": "invalid_api_key", "detail": "string"}{ "error": "invalid_api_key", "detail": "string"}