Skip to main content

Webhook

Send reports to custom HTTP endpoints for integration with any system.

Webhook delivery interface configuration showing URL, HTTP method, headers, and JSON body options

Use cases​

  • Custom notification systems
  • Integration with ticketing tools
  • Triggering automation workflows
  • Sending to unsupported platforms

Configuration​

FieldDescriptionRequired
NameInterface identifierYes
URLEndpoint URL. Can contain $MESSAGEYes
MethodHTTP method (GET or POST, default POST)Yes
HeadersCustom headers (Header name, Header value)No
Body typejson or form. Shown only for POSTYes
JSON bodyCustom payload template (body type json)No
Form bodyKey-value pairs (body type form)No

Payload format​

JSON template​

Define a JSON structure that works with your endpoint in JSON body. Use the $MESSAGE variable as a placeholder for the report content. Anaphora replaces this variable with the text that you define in the job's delivery settings. Click Pretty print to format the JSON.

Example:

{
"title": "Anaphora Report",
"content": "$MESSAGE"
}

Form body​

Send key-value pairs (Form name, Form value) as form data. Use the $MESSAGE variable for the report content.

Example:

report_title=Anaphora Report
report_content=$MESSAGE

JSON in job delivery​

Select Define body in job instead. Each job then defines the entire JSON body in its delivery settings.

Custom headers​

Add headers for authentication or routing:

Authorization: Bearer your-token
X-Custom-Header: value

Anaphora sets Content-Type from the body type.

Testing​

Click Test, enter an optional Test message, then click Send to webhook.

Response handling​

A delivery succeeds only when the webhook answers with a 2xx status. Any other answer fails the delivery, and the run shows the status and the answer of the webhook. The Test button, the health monitor, the license alert and the AI budget alert use the same check.

Test route removed

The route /guest/api/test/webhook no longer exists. If a webhook interface points at it, point it at a real receiver. A webhook that answers "not found" fails the delivery.