Webhooks

Configure event hooks to trigger workflows when emails arrive or are sent. Works with n8n, Zapier, Make, and any HTTP endpoint.

Overview

Webhooks let you receive HTTP notifications when events occur in your agent's inbox. When an email arrives or is sent, 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.

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