# ReceiveHQ Webhook API

> HTTP delivery protocol for inbound email webhooks. Drop-in shapes for Postmark JSON, Mailgun/SendGrid multipart, and CloudMailin JSON.

Full interactive field tables: [https://receivehq.com/docs](https://receivehq.com/docs)

## Overview

ReceiveHQ accepts mail on your domain (MX → `mx.receivehq.com`), parses MIME, and delivers to one or more HTTPS webhook endpoints you configure per tenant.

## Payload formats (per endpoint)

1. **Postmark** — JSON with `From`, `FromName`, `To`, `OriginalRecipient`, `Subject`, `MessageID`, `TextBody`, `HtmlBody`, `Attachments` (base64 `Content`), `Headers`, `RawEmail`, and related fields.
2. **Mailgun / SendGrid** — multipart form fields: `text`/`html`, `body-plain`/`body-html`, `envelope`, `attachment1` / `attachment-1`, raw MIME parts.
3. **CloudMailin** — JSON with `envelope`, `headers`, `plain`, `html`, and base64 `attachments`.

Pick the format your existing handler already expects — no rewrite required.

## Delivery semantics

- Success: HTTP 2xx
- Permanent drop: HTTP 406 (no further retries)
- Other failures: automatic backoff retries (1m → 5m → 30m → 1h → 2h), per-endpoint max attempts
- Optional Basic auth on your webhook URL
- User-Agent: `receivehq-inbound/1.0`

## Getting started

1. Sign up at [https://receivehq.com/](https://receivehq.com/) (magic link).
2. Create a tenant → add inbound domain → point MX to ReceiveHQ.
3. Create a webhook endpoint with the desired payload format.
4. Send a test mail; inspect deliveries in the console ([https://receivehq.com/inbox](https://receivehq.com/inbox)).

## MCP

Agents can manage domains, endpoints, messages, and billing via MCP: [https://receivehq.com/mcp.md](https://receivehq.com/mcp.md) · [https://receivehq.com/llms.txt](https://receivehq.com/llms.txt)

## Pricing

€10/month or €100/year · up to 100,000 inbound emails · then €10 per additional 100k · first 10 emails free · hosted in Germany.
