Webhooks

Configure event hooks to trigger workflows when emails, calendar events, storage documents, or scheduled emails change. Works with n8n, Zapier, Make, and any HTTP endpoint.

Overview

Webhooks let you receive HTTP notifications when events occur across your agent's inbox, calendar, storage, and scheduled emails. Xobni.ai sends a POST request to your configured URL with a JSON payload containing event details.

Important: Your endpoint must accept POST requests with a Content-Type: application/json body. If you're using n8n, Zapier, or similar tools, make sure the webhook trigger is set to POST (not GET).

How it works

Create a webhook with a target URL and event types
Save the signing secret (shown only once)
When an event fires, your URL receives a signed HTTP POST request with a JSON body
Verify the HMAC-SHA256 signature and process the event

Available Events

email.received

Fired when an inbound email arrives in the agent's inbox.

email.sent

Fired when an outbound email is sent from the agent.

calendar.event_reminder

Fired 15 minutes before a confirmed calendar event starts.

scheduled_email.sent

Fired when a scheduled email is successfully sent.

scheduled_email.failed

Fired when a scheduled email fails after all retry attempts.

document.created

Fired when a new document is stored in agent storage.

Creating a Webhook

Via the dashboard or the API.

Dashboard: Go to your agent's detail page and click the "Webhooks" tab to create and manage webhooks.

API: Use the REST API or MCP tools to create webhooks programmatically.

curl - Create webhook

curl -X POST https://api.xobni.ai/api/v1/event-hooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "<agent-uuid>",
    "url": "https://your-n8n.example.com/webhook/abc123",
    "events": ["email.received"],
    "description": "n8n email processor"
  }'

The response includes a secret field — save it securely. It's needed to verify webhook signatures and is shown only once.

Delivery & Retries

Xobni.ai delivers events as HTTP POST requests with the following behavior:

HTTP method:POST (with JSON body)Timeout:10 seconds per attemptMax attempts:3 (with exponential backoff)Retry intervals:~1 min, ~5 min, ~15 minSuccess criteria:Any 2xx HTTP responseLog retention:30 days

Trusted Senders Payload Format