---
title: "Mailboxes"
description: "Create and manage the email addresses on your verified domain, from the dashboard or the API."
source: "https://www.mailmark.dev/docs/mailboxes"
site: "Mailmark"
---

# Mailboxes

Mailboxes are the email addresses on your verified domain. You can create, manage, and send from them via the dashboard or API.

## Creating mailboxes

A mailbox represents a single email address on your domain, e.g. `support@acme.com`. You must have a verified domain before creating mailboxes.

From the dashboard:

1. Go to Dashboard -> Mailboxes and click New mailbox.
2. Enter the local part (e.g. `support`) and an optional display name.
3. Click Create. The mailbox is ready to use immediately.

Via the API:

```javascript
import { Mailmark } from 'mailmark-sdk';

const client = new Mailmark('dm_live_your_api_key');

const mailbox = await client.createMailbox({
  address: 'support',       // -> support@yourdomain.com
  displayName: 'Support Team',
});

console.log(mailbox.fullAddress); // support@yourdomain.com
```

The domain suffix is appended automatically. Pass only the local part (before the @).

Deleting a mailbox also permanently deletes all emails stored in it. This cannot be undone.

```javascript
await client.deleteMailbox('support');
// or use the full address:
await client.deleteMailbox('support@yourdomain.com');
```

## Managing aliases

Aliases let multiple email addresses deliver to the same mailbox. For example, `help@acme.com` and `contact@acme.com` can both route to the `support` mailbox.

To create an alias, go to Dashboard -> Mailboxes -> select a mailbox -> Aliases -> Add alias and enter the alias address. Aliases count towards your domain's mailbox limit on some plans.

Aliases receive mail but cannot be used as sender addresses. To send from a different address, create a separate mailbox.

## Team mailbox permissions

By default every mailbox on a domain is accessible to the domain owner. Sender Groups control which mailboxes can send as part of a group, letting you segment access without sharing credentials.

To grant a team member access to a specific mailbox via the API, create a separate API key scoped to that domain and share only that key. API keys are scoped per domain, so a key cannot access mailboxes on a domain it was not issued for.

Team member invites and per-user mailbox permissions are on the roadmap.

## Connecting an email client (IMAP)

Mailmark supports IMAP for reading received email through standard clients such as Apple Mail, Thunderbird, or Outlook.

| Setting | Value |
| ------- | ----- |
| Server | imap.mailmark.dev |
| Port | 993 |
| Security | SSL / TLS |
| Username | your full email address |
| Password | your Mailmark account password |

IMAP access is read-only. Sending always goes through the Mailmark dashboard or API.

## Next steps

- [Email Campaigns](/docs/email-campaigns) - use mailboxes to run bulk campaign sends.
- [API: Mailboxes](/docs/api#list-mailboxes) - full REST API reference for mailbox management.

---

Mailmark - email hosting and campaigns for your own domain. Canonical page: https://www.mailmark.dev/docs/mailboxes | [llms.txt](https://www.mailmark.dev/llms.txt) | [OpenAPI](https://www.mailmark.dev/openapi.json) | [sitemap](https://www.mailmark.dev/sitemap.xml)