Webhooks
Create a Webhook
Configure the account's webhook endpoint and event subscriptions.
POST
/v1/webhooks- Authentication
- Bearer API key
- Request
- application/json
- Response
- 201 JSON
- Billing
- No direct charge
- Execution
- Immediate
Each account may have one webhook endpoint. The URL must be public HTTPS; use PATCH /v1/webhooks/{id} to change an existing configuration.
Body parameters
| Name | Type | Description |
|---|---|---|
| urlrequired | string | Public HTTPS endpoint that receives JSON POST requests. Maximum 2,048 characters. |
| eventsrequired | string[] | One to four distinct lifecycle events: job.ready, job.failed, run.completed, and run.failed. |
curl -X POST 'https://api.gluecrawl.ai/v1/webhooks' \ -H 'Authorization: Bearer glue_yourApiKeyHere' \ -H 'Content-Type: application/json' \ -d '{ "url": "https://example.com/webhooks/gluecrawl", "events": ["job.ready", "run.completed"] }'Responses
application/json
{ "id": "7f5a3b8d-2d70-4e20-9bf7-c80673f10916", "url": "https://example.com/webhooks/gluecrawl", "events": ["job.ready", "run.completed"], "enabled": true, "created_at": "2026-08-02T14:00:00Z", "updated_at": "2026-08-02T14:00:00Z", "last_delivery": null}