Skip to content
Coritan Docs

Create an account

Sign up with your own email address or with a new Coritan mailbox, then sign in to the dashboard.

View as Markdown

In the dashboard

Create a Coritan account to order and manage services. Anyone can hold an account. You sign in with an email address you already have, or with a new @coritan.gg mailbox that Coritan creates for you at the same time. You do not need to confirm the address before you use the account.

  • Choose a password of 8–128 characters that has at least one lowercase letter, one uppercase letter, one digit and one symbol.
  • If you sign up with your own address, use one you can read. Password reset links go to it.
  • If someone sent you a referral link, open the sign-up page from it. The form then says You are signing up with referral code 7KQ2MXPA., and the new account is linked to theirs (Earn credit with referrals).

Sign up with your email address

Section titled Sign up with your email address
  1. Go to coritan.com/sign-up, or select Sign up at the top of the home page.
  2. If the form shows How to sign in, keep Use your email selected.
  3. Enter your address in Email address.
  4. Enter a Password. The hint under the field lists what it still needs, and shows Meets every rule when it passes.
  5. Enter the same password in Confirm password.
  6. Under the password, you can enter your First name and Last name. Both are optional, and you can add them later in your profile.
  7. If a verification check appears, complete it.
  8. Select Create account.

When Coritan offers mailboxes at sign-up, How to sign in has a second option that creates a @coritan.gg inbox. The new address becomes the email you sign in with, and the inbox opens in Webmail. A new mailbox can send to fewer people in its first 7 days (Sending limits).

  1. On the sign-up form, under How to sign in, choose the option to create a @coritan.gg inbox.
  2. Type a name in Your new address. Use lowercase letters, digits, dots, hyphens and underscores, up to 40 characters, starting and ending with a letter or a digit. The form checks the name as you type and says whether it is available.
  3. Optionally, enter a Recovery email. A password reset link goes to this address as well as to the new inbox, so add one if you can.
  4. Enter a Password and type it again in Confirm password. The mailbox uses the same password. You can add your First name and Last name under them, both optional.
  5. If a verification check appears, complete it.
  6. Select Create account and mailbox.

You are signed in. If you came to the sign-up page from a page that needs an account, such as Order now on a server page, that page opens next, with the plan you chose. Otherwise, with your own address, the dashboard opens and offers you a free coritan.gg name, which you can claim now or later. Once account plans open on your account, it opens on What do you want to do first? instead, and the Dashboard offers the name later (Choose what to do first). With a new mailbox, webmail opens on your inbox and says Your inbox is ready. Coritan sends a welcome email to the account's address.

Next, add credit or order a service.

Email already registered.
An account already uses that address. Select Sign in, or reset your password if you do not remember it.
The password hint says Still needs something
The password is missing a character type or is shorter than 8 characters. Add what the hint lists.
Complete the verification check to continue.
The verification check has not finished. Complete it, then select the button again.
The verification check did not pass. Complete it and try again.
The check expired or was refused. It resets after every attempt, so complete it again.
That address is already taken. or That name is reserved.
Someone has that mailbox name, or Coritan keeps it back. Choose another name.
The form switches back to Use your email with a notice
Coritan could not create mailboxes at that moment. Sign up with an address you already have, or try the mailbox again in a few minutes.
Too many authentication attempts. Please try again later.
Your network sent too many sign-up attempts that failed. Wait a minute and try again. Rate limits lists every limit.
Too many requests for this action. Try again later. when you sign up with a new mailbox
One network can make 3 coritan.gg mailboxes an hour and 5 a day, counting the ones claimed later in webmail. An IPv6 address counts as its /64 network. Wait, or sign up with an email address you already have.
Mailboxes cannot be made from this network. Sign up with an email address you already have.
We do not make mailboxes for the network you are on. Sign up with your own address, or sign up with a mailbox from another network, such as your home connection or your phone's.
Mailboxes cannot be made from a hosting, VPN, proxy or Tor network. Sign up with an email address you already have.
Turn off the VPN or proxy and sign up again, or use your own address.
We paused a mailbox made from this network in the last 7 days, so it cannot make another for now. Sign up with an email address you already have.
A mailbox made from the same address was paused for the mail it sent. Sign up with your own address, or with a mailbox from another network.

Check first whether sign-up needs a verification token. The endpoint needs no authentication:

Shell
curl https://api.coritan.com/api/v1/auth/turnstile
JSON
{"enabled": false, "site_key": ""}

When enabled is true, every sign-up request needs a turnstile_token that only the widget in a browser can produce, so create the account on the website instead.

Create the account with POST /auth/register. Send exactly one of email and mailbox_local_part. The other fields are password, and optionally first_name, last_name, company, recovery_email (with a mailbox only), turnstile_token and referral_code. Put the code from someone's referral link in referral_code. Coritan ignores a code that does not count, such as an unknown one, and still creates the account.

Shell
curl -X POST https://api.coritan.com/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "alex@example.com", "password": "Correct-horse-9", "first_name": "Alex"}'

The answer is a token pair, so the new account is signed in at once. expires_in is the access token's lifetime in seconds.

JSON
{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "refresh_token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "bearer",
  "expires_in": 1800
}

A password that breaks a rule answers 422 with the rule, such as Password must contain at least one uppercase letter. An address with an account answers 409 Email already registered. With mailbox_local_part, a network past its mailbox budget answers 429 (mail.signup_mailbox in Rate limits), and a network we make no mailbox for answers 403 with one of the reasons under Troubleshooting.

To offer a mailbox, ask which domain the storefront uses with GET /auth/mailbox-domain, then check a name with GET /auth/mailbox-availability:

Shell
curl "https://api.coritan.com/api/v1/auth/mailbox-availability?local_part=alex"
JSON
{"available": true, "reason": "ok", "detail": null, "address": "alex@coritan.gg"}

reason is ok, invalid, reserved or taken, and detail says why a name cannot be used. When there is no mailbox to offer, the domain endpoint answers "enabled": false and the availability check answers 404 Mailboxes are not offered on this storefront. The availability check is rate-limited per IP address, and an IPv6 address counts as its /64 network.

API operations on this page

MethodPathWhat it does
POST/api/v1/auth/registerCreate an account and sign it in
GET/api/v1/auth/mailbox-availabilityLive check behind the sign-up form's username field
GET/api/v1/auth/mailbox-domainMailbox domain
GET/api/v1/auth/turnstileTurnstile config