# Get a coritan.gg mailbox

> Take an address on coritan.gg when you create your Coritan account, or claim one later in webmail.

Source: https://docs.coritan.com/mail/webmail/claim-a-mailbox/

In the dashboard:

- /webmail: https://www.coritan.com/webmail

A Coritan account can have one mailbox of its own on `coritan.gg`, such as `alex@coritan.gg`. You take the address when you create your account, or you claim it later in [webmail](https://www.coritan.com/webmail). You read the mail in webmail, and in any mail app over IMAP.

This page covers claiming the mailbox later. To take one while you sign up, see [Sign up with a new mailbox](/get-started/create-an-account/#sign-up-with-a-new-mailbox).

## Before you begin

- Be signed in on coritan.com. Webmail offers the address only to your Coritan sign-in, so a mailbox you opened with its own address and password cannot claim one.
- Have your Coritan password.
- Check that you have no mailbox yet. An account can claim one mailbox, and a mailbox you took at sign-up is that one.

## Choose a name

The name is the part before `@coritan.gg`. It must:

- be 3–40 characters long;
- use only letters, digits, dots, dashes and underscores, which webmail reads in lowercase;
- start and end with a letter or a digit;
- have no two dots in a row and no plus sign.

Some names are reserved, such as `support`, `billing` and `webmail`. A name is also taken when a Coritan account already signs in with that address.

## Claim your mailbox

1. Go to [Webmail](https://www.coritan.com/webmail). While your account has no mailbox, webmail shows `Claim your @coritan.gg address`.
2. Type a name in **Your address**, or select one of the ideas under the field. Webmail checks the name as you type, and the line under the field says `alex@coritan.gg is free.` when it is.
3. Enter your Coritan password in the field under it. It confirms that it is you, and it becomes the mailbox's password too.
4. Select **Create my mailbox**.

A message says `alex@coritan.gg is yours.`, and your new inbox opens. You go on signing in to Coritan with the email you use now. The new address is where your mail arrives.

The same page lists any invitation to a mailbox someone shared with you, with **Accept** and **Decline**. Under **Have a mailbox already?**, **Add a mailbox** adds one you manage to your account, as [Add a mailbox to your account](/mail/webmail/mailboxes-and-sharing/#add-a-mailbox-to-your-account) describes.

## What the mailbox comes with

- 5 GB of storage by default. The line under the folder list shows how much you use.
- Up to 100 messages sent an hour by default.
- Sign-in from mail apps over IMAP and SMTP, with the mailbox's address and password. See [Set up mail apps and devices](/mail/webmail/mail-apps/).

## The mailbox password

The mailbox password starts as your Coritan password. When you [change your account password](/account/password/#change-your-password), the mailbox password changes with it, and mail apps need the new one.

You can give the mailbox a password of its own on the **Security** tab of webmail settings. From then on it stays as it is when your account password changes. See [Change the mailbox password](/mail/webmail/security/#change-the-mailbox-password).

## Troubleshooting

`That address is already taken.`
: Someone has a mailbox with that name, or a Coritan account signs in with that address. Choose another name.

`That name is reserved.`
: We keep that name back. Choose another name.

`Pick at least 3 characters.`, `Keep it under 40 characters.`, `Two dots in a row are not allowed.` or a message about the characters to use
: The name breaks one of the [naming rules](#choose-a-name). Change it until the line under the field says it is free.

`Pick a free address first.`
: You selected **Create my mailbox** with no name in **Your address**. Type a name, and wait until the line under the field says it is free.

`Could not check that name just now. You can still try it.`
: We could not check the name. Select **Create my mailbox** anyway, or type the name again after a moment.

`Incorrect account password.`
: Enter the password you sign in to your Coritan account with.

`The mail service is not accepting new mailboxes right now. Try again in a moment.`
: We could not create the mailbox at that moment. Nothing was created, so try again later.

`This account already has a mailbox.`
: Your account has its mailbox already, and webmail opens it.

`No mailbox in your account yet`
: This site does not give out addresses, so the page offers only **Add a mailbox** and the invitations waiting for you. For mailboxes on a domain you own, see [Mail Hosting](/mail/mail-hosting/).

A message that starts `Could not create the mailbox:` and says there were too many requests
: An account can try to claim a mailbox 5 times an hour. Wait, then try again.

`Your account could not be read`
: Webmail could not load what your account can claim. Select **Try again**.

## Related

- [Create an account](/get-started/create-an-account/)
- [How webmail works](/mail/webmail/)
- [Set up mail apps and devices](/mail/webmail/mail-apps/)

## With the API

The claim itself happens in webmail only. The public API has the two checks that the sign-up form makes before an account exists. Neither needs authentication.

Ask whether the storefront offers a mailbox, and on which domain, with [`GET /auth/mailbox-domain`](/api/reference/client/authentication/#op-get-api-v1-auth-mailbox-domain):

```bash
curl https://api.coritan.com/api/v1/auth/mailbox-domain
```

```json
{"enabled": true, "domain": "coritan.gg"}
```

Check a name with [`GET /auth/mailbox-availability`](/api/reference/client/authentication/#op-get-api-v1-auth-mailbox-availability):

```bash
curl "https://api.coritan.com/api/v1/auth/mailbox-availability?local_part=alex"
```

```json
{"available": false, "reason": "taken", "detail": "That address is already taken", "address": "alex@coritan.gg"}
```

`reason` is `ok`, `invalid`, `reserved` or `taken`, and `detail` says why a name cannot be used. When the storefront offers no mailbox, the domain check answers `"enabled": false` and the availability check answers `404` `Mailboxes are not offered on this storefront`. One IP address can check up to 60 names a minute.

To create an account together with its mailbox, send `mailbox_local_part` to `POST /auth/register`, as [Create an account](/get-started/create-an-account/#with-the-api) shows.

## API

- `GET /api/v1/auth/mailbox-domain`: Mailbox domain (https://docs.coritan.com/api/reference/client/authentication/#op-get-api-v1-auth-mailbox-domain)
- `GET /api/v1/auth/mailbox-availability`: Live check behind the sign-up form's username field (https://docs.coritan.com/api/reference/client/authentication/#op-get-api-v1-auth-mailbox-availability)
