Webhook Management
Configure webhooks to receive real-time event notifications for your mailboxes.
Loading configuration...
Configure webhooks to receive real-time event notifications for your mailboxes.
Receive real-time event notifications for your tenant
Add a webhook endpoint to start receiving real-time event notifications.
Your server must respond with a 2xx status code within 30 seconds.
Ensure the queue policy allows AgentMailbox to send messages.
Download our CloudFormation template to create a properly configured SQS queue with the correct permissions.
Ensure the topic policy allows AgentMailbox to publish messages.
Download our CloudFormation template to create a properly configured SNS topic.
We'll send events to your EventBridge bus in your account.
Download our CloudFormation template to create a properly configured EventBridge bus.
PAYLOAD ENVELOPE
{
"id": "evt_01J...",
"type": "message.received",
"created_at": "2026-04-09T10:00:00Z",
"webhook_id": "<id>",
"tenant_id": "...",
"data": { /* event-specific */ }
}
message.received DATA
{
"mailbox_address": "support@tenant.agentmailbox.to",
"message_id": "uuid",
"subject": "Re: Your order",
"from_address": "customer@example.com",
"received_at": "2026-04-09T10:00:00Z",
"has_attachments": false,
"thread_id": "uuid-or-null"
}