Learn
Mailboxes
Named addresses like support@ with their own inbox and webhook.
Mailboxes
A mailbox is a named receiving address on your domain, such as support@yourdomain.com. Each one has its own inbox and can post to its own webhook.
Dashboard
- Open Mailboxes and type the address (e.g.
support), pick the domain and click Create mailbox. - The first mailbox switches on receiving for that domain. Add the MX record shown on the domain page once.
- Click the address to see its emails. Plus-addresses work:
support+orders@lands insupport@.
Catch-all: on by default, so every address @ your domain is accepted. Turn it off on the Mailboxes page and only your listed mailboxes receive mail; anything else is dropped.
API
| Method | Path | Body / query |
|---|---|---|
| POST | /mailboxes | { "address": "support@yourdomain.com", "name": "Support", "webhook_id": "optional" } |
| GET | /mailboxes | ?domain_id= (optional) |
| GET | /mailboxes/{id} | |
| PATCH | /mailboxes/{id} | { "name": "…", "webhook_id": "…" or null } |
| DELETE | /mailboxes/{id} | emails already received are kept |
| PATCH | /domains/{id} | { "receiving": true, "catch_all": false } |
| GET | /emails/receiving | ?to=support@yourdomain.com or ?mailbox_id= |
curl -X POST 'https://post-waves.com/mailboxes' -H 'Authorization: Bearer pw_...' -H 'Content-Type: application/json' \
-d '{"address":"support@yourdomain.com","name":"Support"}'Webhooks
Every received email fires email.received with mailbox_id in its data. If a mailbox has its own webhook, that webhook gets only that mailbox's emails. Your other email.received webhooks still get every email.
Was this page helpful?Send feedback