Get started

Quickstart

Receive your first email as a signed webhook in five minutes.

BetterMX turns incoming email into API calls, WhatsApp messages, and forwards. Create an endpoint with an address, point it at a destination, and every email that arrives is parsed, verified, and delivered.

1. Get an API key

Sign in to the dashboard, open API keys, and create one. Keys look like bmx_live_… and are shown once.

2. Create an endpoint

bash
curl https://api.bettermx.io/v1/endpoints \
  -H "Authorization: Bearer bmx_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Inbound orders",
    "address": { "type": "managed", "label": "orders" },
    "destinations": [
      { "type": "webhook", "url": "https://your-app.com/hook" }
    ]
  }'

The response contains your new address (e.g. orders-k7qf3m9xab@inbox.bettermx.io) and a webhook signing secret (shown once).

3. Send an email to it

Email that address from anywhere. Within seconds your webhook receives a signed JSON payload with the parsed message.

Managed addresses work instantly — no DNS required. Prefer your own domain? See the Domains guide.