Webhooks

Configure approval webhooks to review replies before they are posted.

Approval Webhook

When approval mode is enabled, Apex sends a webhook to your configured URL before posting each reply. You can approve, reject, or edit the reply.

Configuration

Approval webhooks are configured through the Apex dashboard at apexagents.ai. Set the webhook URL in your account settings under Approval Options.

Webhook Payload

Apex sends a POST request with the following JSON body:

Expected Response

Your webhook should respond with a JSON body indicating the action:

Actions: approve, reject, edit (provide editedText).

Example Webhook Handler

A minimal Node.js Express handler that auto-approves all replies:

webhook-handler.js

Timeout Behavior

If your webhook does not respond within 30 seconds, the reply is held and not posted. Apex does not retry failed webhooks automatically — ensure your endpoint is reliable and fast.