# Email

> Host mailboxes on your own domain with Mail Hosting, send your applications' mail with SMTP Relay, and read mail in webmail.

Source: https://docs.coritan.com/mail/

In the dashboard:

- /solutions/mail: https://www.coritan.com/solutions/mail
- /dashboard/mail: https://www.coritan.com/dashboard/mail

Coritan has two mail products. *Mail Hosting* gives people mailboxes on your own domain, which they read in a mail app or in webmail. *SMTP Relay* sends the mail your software writes, such as receipts, password resets and newsletters, over SMTP or an HTTPS API, and reports what happened to each message.

Both run in the region you choose when you order, and both use DNS records on your domain to prove the mail is yours. You can order more than one of each.

## What you can do

Start here:

- [Order Mail Hosting or SMTP Relay](/mail/order-a-mail-service/)
- [Mail DNS records](/mail/dns-records/): what each record is for and how to publish it
- [How the DMARC stage ramp works](/mail/dmarc/)

Mail Hosting:

- [How Mail Hosting works](/mail/mail-hosting/)
- [Add a domain to Mail Hosting](/mail/mail-hosting/add-a-domain/)
- [Create and manage mailboxes](/mail/mail-hosting/mailboxes/)
- [Secure a mailbox](/mail/mail-hosting/mailbox-security/) with two-factor sign-in and app passwords
- [Forward addresses with aliases](/mail/mail-hosting/aliases/)
- [Connect a mail app](/mail/mail-hosting/connect-a-mail-app/)
- [Move existing mail into a mailbox](/mail/mail-hosting/move-mail-in/)
- [Change Mail Hosting settings](/mail/mail-hosting/settings/)

SMTP Relay:

- [How SMTP Relay works](/mail/smtp-relay/)
- [Add a sending domain](/mail/smtp-relay/add-a-sending-domain/)
- [Send over SMTP with credentials](/mail/smtp-relay/credentials/)
- [Create and revoke send API keys](/mail/smtp-relay/api-keys/) and [send email over HTTPS](/mail/smtp-relay/send-with-the-api/)
- [Transactional and marketing mail](/mail/smtp-relay/message-categories/)
- [Receive delivery events with webhooks](/mail/smtp-relay/webhooks/), [look up message events](/mail/smtp-relay/events/) and [manage the suppression list](/mail/smtp-relay/suppressions/)
- [How sending limits work](/mail/smtp-relay/sending-limits/) and [request a higher hourly limit](/mail/smtp-relay/request-a-higher-limit/)
- [Sending reputation and deliverability](/mail/smtp-relay/deliverability/)

Webmail:

- [How webmail works](/mail/webmail/), from [getting a free coritan.gg mailbox](/mail/webmail/claim-a-mailbox/) to [filters](/mail/webmail/labels-and-filters/) and [keyboard shortcuts](/mail/webmail/keyboard-shortcuts/)

When something goes wrong, see [Troubleshoot mail](/mail/troubleshooting/).

## Find your mail services

In the dashboard, go to **Email**. The list shows every Mail Hosting and SMTP Relay service on your account, with its **Domain**, **Product**, **Status**, **Plan** and **Since** date. Filter it by status, or search by domain or plan. Select a row to open the service's panel.

The **Plan** column says what the service holds: a count of mailboxes for Mail Hosting, and the monthly email allowance for SMTP Relay. A service that is still being set up reads `Not set up yet`.

To order, select **Order Mail Hosting** or **Order SMTP Relay** at the top of the list. Each opens the product's order page. The public [Mail page](https://www.coritan.com/solutions/mail) lists the current plans before you sign in.

## Billing

Each service is billed for its plan and renews every billing cycle until you cancel it. SMTP Relay's order page also offers a free plan. [How Mail Hosting and SMTP Relay are billed](/mail/billing/) covers plan changes, the monthly sending allowance and cancelling.

## Limits that apply to every mail service

- A service lives in the region you chose when you ordered it, and its mail is stored there.
- Prove you own a domain and publish its records before you send from it. A domain counts as verified once its ownership, SPF and DKIM checks pass, and for Mail Hosting its MX check too. See [Mail DNS records](/mail/dns-records/).
- A domain can be on one mail service at a time. To use a domain on both products, give the relay a sending subdomain, such as `send.example.com`.
- The plan sets how many domains, mailboxes or SMTP credentials the service may hold. The panel shows each count against its limit.
- Coritan pauses a service's sending when its bounce or complaint rate crosses the platform's limit. See [Sending reputation and deliverability](/mail/smtp-relay/deliverability/).

## With the API

List your mail services:

```bash
curl https://api.coritan.com/api/v1/client/mail/services \
  -H "Authorization: Bearer $CORITAN_TOKEN"
```

`GET /client/smtp-relay/services` returns the same list. Both answer `{"items": [...], "total": n}` with one item for every Mail Hosting and SMTP Relay service on your account:

```json
{
  "items": [
    {
      "service_id": 4812,
      "tenant_id": 97,
      "internal": false,
      "module_name": "smtp_relay",
      "product_name": "Relay 50K",
      "status": "active",
      "hostname": "send.example.com",
      "tenant": { "...": "..." },
      "created_at": "2026-09-01T10:12:00"
    }
  ],
  "total": 1
}
```

`module_name` is `mail` for Mail Hosting and `smtp_relay` for SMTP Relay. Use `service_id` as `{service_id}` in every other mail request. The two prefixes share one set of routes, so `/client/mail/{service_id}/...` and `/client/smtp-relay/{service_id}/...` reach the same service. An operation that belongs to the other product answers `400` or `404` with a message that says so, such as `Mailboxes are only available on Mail Hosting services`.

An item with `"internal": true` and `"service_id": null` is an [internal mail tenant](/mail/internal-tenants/). Reach it through `/client/platform-mail/{tenant_id}/...` instead.

A service that is still being set up answers `409` `This mail service is still provisioning`. See [Authentication](/api/authentication/) for tokens.

## API

- `GET /api/v1/client/mail/services`: List services (https://docs.coritan.com/api/reference/client/mail/mail/#op-get-api-v1-client-mail-services)
- `GET /api/v1/client/smtp-relay/services`: List services (https://docs.coritan.com/api/reference/client/mail/smtp-relay/#op-get-api-v1-client-smtp-relay-services)
