Webhooks

​

Creating a Custom Webhook

1. Open Webhooks in the sidebar (under Capabilities in settings).
2. Create a webhook: pick a type — Bearer Token is the generic choice — give it a description, and choose whether it’s shared or personal.
3. The confirmation page reveals the Webhook URL and the secret (shown as the Signing Secret) once — copy both before leaving the page. The secret cannot be retrieved later. Send it as a bearer token on every request (see below).

POST https://{tenant}.api.augmentcode.com/webhooks/{webhook_id}
Authorization: Bearer <bearer-secret>
Content-Type: application/json

​

Common Webhook Examples

​

Datadog — Error Alert

1. Create a webhook and copy the URL + bearer secret.
2. In Datadog → Integrations → Webhooks, configure a custom webhook with the trigger URL and add Authorization: Bearer <bearer-secret> under Custom Headers.
3. On the Automations page, add a Webhook trigger, pick the new custom webhook from the Webhook dropdown, and set Filter to match the alerts you care about:
   {"and": [
     {"==": [{"var": "alert_type"}, "error"]},
     {"in": [{"var": "priority"}, ["P1", "P2"]]}
   ]}
   

​

CircleCI — Workflow Failed

1. Generate a webhook the same way.
2. In CircleCI → Project Settings → Webhooks, configure a webhook with the trigger URL and add Authorization: Bearer <bearer-secret> under headers.
3. On the Automations page, add a Webhook trigger pointing at the new custom webhook with Filter:
   {"and": [
     {"==": [{"var": "type"}, "workflow-completed"]},
     {"==": [{"var": "workflow.status"}, "failed"]}
   ]}
   

​

Test Any Custom Webhook with curl

curl -X POST "https://${TENANT}.api.augmentcode.com/webhooks/${WEBHOOK_ID}" \
  -H "Authorization: Bearer ${WEBHOOK_BEARER_SECRET}" \
  -H "Content-Type: application/json" \
  -d '{"action": "ping", "message": "hello from curl"}'

​

See Also

• Configuring Triggers — the full trigger reference, including event types and filters.
• Managing Automations — inspect captured webhook events in the events log.
• Your First Automation — build two automations end to end.