API: Webhooks
Outbound event notifications (standard and Slack-format). All endpoints require authentication unless noted. 6 endpoints.
GET /api/webhooks
Section titled “GET /api/webhooks”List webhooks for workspace
Responses: 200 · 400 · 401
POST /api/webhooks
Section titled “POST /api/webhooks”Create a webhook
Request body (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
name |
string | yes | |
url |
string | yes | |
kind |
"generic" | "slack" |
no | |
events |
array of string | yes | |
secret |
string | no | |
headers |
object | no |
Responses: 201 · 400 · 401 · 409
PUT /api/webhooks/{id}
Section titled “PUT /api/webhooks/{id}”Update a webhook
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes |
Request body (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
name |
string | no | |
url |
string | no | |
events |
array of string | no | |
secret |
string | no | |
headers |
object | no | |
isEnabled |
boolean | no |
Responses: 200 · 400 · 401 · 404
DELETE /api/webhooks/{id}
Section titled “DELETE /api/webhooks/{id}”Delete a webhook
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes |
Responses: 204 — No content · 401 · 404
GET /api/webhooks/{id}/deliveries
Section titled “GET /api/webhooks/{id}/deliveries”List recent deliveries for a webhook
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
limit |
integer | no | |
offset |
integer | no |
Responses: 200 · 400 · 401
POST /api/webhooks/{id}/test
Section titled “POST /api/webhooks/{id}/test”Send a test webhook payload
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes |
Responses: 200 · 400 · 401 · 404