Webhooks
Webhooks let you configure outbound HTTP requests to external services. Open Webhooks from the sidebar to manage them.
The Webhooks Page
Section titled “The Webhooks Page”The page has two sections:
- New Webhook / Edit Webhook — A form for creating or editing webhooks.
- Webhooks — A list of all configured webhooks with status, actions, and test results.
Creating a Webhook
Section titled “Creating a Webhook”Fill in the New Webhook form:
| Field | Description |
|---|---|
| Name | Descriptive name (e.g., “Deploy Notification”), up to 60 characters |
| Method | HTTP method: GET, POST, PUT, PATCH, or DELETE. Defaults to POST. |
| URL (required) | The target URL. Must start with http:// or https://. Validated on blur. |
| Headers | Optional HTTP headers. Use the preset buttons (+ Content-Type, + Authorization, + Custom) to add common headers, or add blank rows for custom ones. Each header has a name and value field. |
| Session Target | The agent session that receives the webhook message. Defaults to main. |
| Message | The prompt sent to the agent when the webhook fires (up to 2000 characters). |
Click Add Webhook to create it. The webhook is enabled immediately.
URL Validation
Section titled “URL Validation”The URL field is validated when you leave the field. If the URL is invalid, an error message appears: “Please enter a valid URL starting with http:// or https://.” The form cannot be submitted with an invalid URL.
Header Presets
Section titled “Header Presets”Three quick-add buttons are available:
| Button | Header Added |
|---|---|
| + Content-Type | Content-Type: application/json |
| + Authorization | Authorization: Bearer (value editable) |
| + Custom | Blank header row for custom name and value |
Click the X button on any header row to remove it.
Managing Webhooks
Section titled “Managing Webhooks”Webhook Cards
Section titled “Webhook Cards”Each webhook is displayed as a card showing:
- Enable/disable toggle — Switch the webhook on or off
- Name
- Method badge — The HTTP method (e.g., “POST”)
- Status badge — Current status (green for “ok”/“active”, red for “error”/“failed”)
- Trigger count — How many times the webhook has fired, with success rate percentage
- URL — The target URL (truncated), with a copy button to copy to clipboard
- Last triggered — When the webhook last fired (relative time)
- Error message — If the last trigger failed, the error is shown
Editing a Webhook
Section titled “Editing a Webhook”Click the pencil icon on a webhook card. The form above populates with the webhook’s current configuration. Make changes and click Save Changes, or click Cancel to discard.
Testing a Webhook
Section titled “Testing a Webhook”Click the play icon on a webhook card to send a test request. The button shows a spinner during the request. When the response arrives, an inline Test Response card appears below the webhook showing:
- HTTP status code — Green badge for success (< 400), red for failure (>= 400)
- Duration — Response time in milliseconds
- Response body — Raw JSON response in a scrollable monospace block
Click Dismiss to close the test result.
Deleting a Webhook
Section titled “Deleting a Webhook”Click the trash icon on a webhook card. The webhook is deleted and an undo toast appears, allowing you to restore it.
Session Target
Section titled “Session Target”The Session Target field controls which agent session receives the webhook message. Use main (the default) for the default agent session. This determines where the webhook’s message is routed when it fires.