mails-ai · AsyncAPI Specification

Mails Ai Webhooks

Version

View Spec View on GitHub CompanyAIEmailInfrastructureAgentsAsyncAPIEvents

AsyncAPI Specification

Raw ↑ 
generated: '2026-10-31'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://mails.ai/docs/webhooks
sources:
- https://mails.ai/docs/webhooks
- https://mails.ai/blog/inbound-email-parsing-webhooks-classification-structured-events
- https://mails.ai/blog/inbound-email-webhook-signatures-prevent-replay-attacks
- https://mails.ai/blog/inbound-email-webhooks-ai-agents-classification-parsing-actions
description: 'Mails.ai webhooks push events to a registered HTTPS endpoint. The endpoint receives a POST with a JSON body and the following delivery
  headers: X-Mails-Signature (HMAC‑SHA256 of "<timestamp>.<raw_body>", with timestamp and one or two v1 signatures), X-Mails-Event-Id, X-Mails-Event-Type,
  User-Agent. The signature is verified using the signing_secret returned when the webhook is created. Deliveries are attempted inline, then retried
  on failure with a back‑off (≈30 s then 120 s) up to three attempts; after the final failure the delivery is moved to a dead‑letter queue (dlq).'
events:
- event: message.received
  description: Delivered when an inbound email is successfully parsed and made available as a structured event.
- event: message.bounced
  description: Delivered when an inbound email cannot be delivered and is bounced.
delivery:
  signature: HMAC‑SHA256(signing_secret, "<t>.<raw_body>")
  retries: up to 3 attempts with back‑off (≈30 s then 120 s), then parked in dead‑letter queue
  content_type: application/json
docs: https://mails.ai/docs/webhooks

Work with this as data

Every AsyncAPI spec here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for asyncapi

4 MCP tools reach this
  • find_asyncapisBrowse and filter every AsyncAPI spec in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This AsyncAPI spec 
curl "https://apis.io/api/v1/asyncapis/mails-ai-webhooks"
All asyncapi 
curl "https://apis.io/api/v1/asyncapis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.