MailwurfPermanent addresses
Fixed addresses that keep receiving mail, and the mail view for every inbox.
Tests should create temporary inboxes through the API. A permanent address is for cases where the address must be known in advance:
- a seeded test user whose email is stored in fixtures,
- a staging account that receives reports or notifications,
- a fixed sender address for mail your tests send.
Register an address
Owners and admins can register addresses.
- Open Inboxes.
- Under Register permanent address, enter an Email name, for example
signup-acme. - If your organization has verified custom domains, pick the domain next to the name. Otherwise the address uses the Mailwurf mail domain, for example
signup-acme@mail.mailwurf.io. - Select Register address.
Rules for the name:
- 3–48 characters on the shared domain, 1–48 on your own domains: lowercase letters, digits,
.,_, and-. - Starts and ends with a letter or digit.
- The full address must not be taken. If it is, choose another name.
- Reserved on the shared domain:
abuse,admin,hostmaster,mailer-daemon,postmaster,root,security,support. On your own domains these names are allowed.
Each organization can have five permanent addresses, across all domains. Delete one to free a slot.
| Message | Meaning |
|---|---|
| Use 3–48 lowercase letters, numbers, dots, underscores or hyphens. | The name breaks the rules above. On your own domains the message says 1–48. |
| This email name is reserved. | Pick a name that is not on the list. |
| This email address is already registered. | Someone already uses this address. |
| This organization already has five permanent addresses. | Delete an address first. |
| Verify the domain before using it for addresses. | The custom domain is still pending. |
Read the mail
Select an address under Organization inboxes to open Mail. It shows two lists, newest first:
- Received: mail delivered to this address. A detected one-time code appears as a badge.
- Sent: mail sent from this address, with its delivery status. Failed messages show the reason.
Select a message to see its content. Any member of the organization can read mail.
In tests, permanent addresses work with the same API calls as temporary inboxes. Look up the inbox by address, then wait:
const inbox = await mailwurf.inboxByAddress("signup-acme@mail.mailwurf.io");
const mail = await inbox.waitFor({ subject: "Weekly report", timeout: 60_000 });Messages in a permanent address are kept until the address is deleted.
Several test runs can reach the same permanent address at the same time. Use after or a unique subject to tell their messages apart, or use temporary inboxes instead.
Organization inboxes
Organization inboxes lists every active address of the organization, both permanent and temporary. Temporary inboxes disappear from the list when they expire after one hour.
Delete an address
Owners and admins can delete permanent addresses.
- Select the trash icon next to the address.
- Confirm with Delete address.
The address stops receiving mail immediately, and its messages are no longer available. API keys cannot delete permanent addresses; the API returns 403.