Order Mail Hosting or SMTP Relay

Order Mail Hosting when people need mailboxes on your domain, and SMTP Relay when software needs to send mail, such as receipts, alerts and newsletters. Each product has an order page of its own, and you can hold several of each. A relay on a large enough plan can also take a dedicated sending IP, which you order for that relay.

• Decide which product you need. How Mail Hosting works and How SMTP Relay works describe each.
• For a paid plan, you pay on the order page. Credit on your account pays first, and a saved payment method, a new card or a wallet pays the rest (How the first payment works).
• Optionally, have a domain whose DNS you can change. You can also add it after the order.
• To use one domain for both products, plan a sending subdomain for the relay, such as send.example.com. A domain can be on one mail service at a time.

Any of these opens the order page for Mail Hosting or SMTP Relay:

• In Mail Services, select Order Mail Hosting, or open the More ways to get email menu beside it and select Order SMTP Relay. With no mail service yet, the page shows a card for each product, Order Mail Hosting and Order SMTP Relay, and the menu stays at the top. Once account plans open on your account, Order SMTP Relay is the top button when the page has nothing better to offer, and Order Mail Hosting is in the menu.
• In a mail service's panel, select Order another in its header. It opens the page for the same product. Once account plans open on your account, only an SMTP Relay's panel has it.
• On Order a service, select the Mail Hosting or SMTP Relay card under Mail Services.

You can also add Mail Hosting or SMTP Relay to a Cloud Compute order or a server order on App Deployment, and SMTP Relay to a Mail Hosting order (Add products to the order).

The page has numbered sections, and the summary under Your order sits beside them. On a phone the summary follows the sections, and the bar at the bottom of the screen shows what is due and has the same button.

1. Under Plan, choose a plan. We start with the plan the catalogue marks Popular, then the one it recommends, or else the first one in stock. A plan marked Sold out is greyed out and cannot be chosen.
   • A Mail Hosting plan shows how many mailboxes it holds, the storage each mailbox gets and how many domains it takes, such as 5 mailboxes · 10 GB each · 1 domain.
   • An SMTP Relay plan shows its emails a month, its price per 1,000, whether it has a buffer over the allowance or stops at the allowance, its sending domains and any dedicated IPs. The free plan shows Free as its price.
2. Check the billing cycle beside the Plan heading. When the plans sell more than one cycle, select one of its buttons, such as Monthly. A longer term names what it saves, such as Yearly · save 20%. Relay plans are billed monthly, so the SMTP Relay page reads Billed monthly there.
3. Under Domain (Mail Hosting) or Sending domain (SMTP Relay), optionally enter a domain such as example.com in First domain or First sending domain. Leave it empty to add domains from the panel later.
   • If you hold free coritan.gg names, they appear beside Your names: under the field. Select one to use it.
4. On a Mail Hosting order, Add-ons offers an SMTP Relay for the mail your applications send. To add one, turn on the switch on the SMTP Relay card. Choose its Plan when the card lists more than one, and optionally enter a Sending domain. Only paid relay plans are offered here: order the free plan on the SMTP Relay page, until account plans open on your account and it comes with your plan.
5. Check the summary. It lists the plan with its billing cycle and the domain, with Change beside each to go back to its section. Under Billed are the plan and any add-on. The Total shows the price for each billing cycle.
6. If you have a promo code, enter it in Promo code. We check it as you type, and the message under the field says whether it applies. A code that cannot be used on this order greys out the button until you change or clear it.
7. Under Due today, read what you pay now. Under Pay with, choose Account credit when it covers the amount, a saved payment method, a new card, or a wallet such as Google Pay. We start with your default saved method.
8. On a free plan, complete the verification check in the summary. We check every order whose plan costs nothing.
9. Select the button under the summary. It reads Place order when nothing is due and Order for free on a free plan. When you pay now it names the amount due, such as Pay $4.99 and order. One click places the order and pays for it, and you stay on the page until it is done.

We do not ask for a region. We set the service up in our mail region, and the panel shows the region's code in its header.

If the button is greyed out, the line under it names the first answer still missing or the reason we refused the order, and selecting it takes you to the section that fixes it. If we refuse the order or the payment is declined, the reason appears under the button and your choices stay as they were. We never place an order twice.

You pay on the order page, so there is usually nothing to pay afterwards. Once the order is placed, its receipt page opens, and its title says what comes next:

• Order placed: the payment went through, nothing was due, or your account is billed in arrears. We are setting up the service, and the page updates on its own.
• Order placed, payment due: we placed the order but could not take the payment. Pay under Pay invoice with account credit, a saved card or PayPal account, or a new card. Setup starts once the payment goes through. Pay and follow the order walks through each way to pay.
• Your order is ready: every service in the order is active.

What you ordered lists the service and any SMTP Relay you added, each with its status and price. To pay later, leave the page and pay the invoice under Invoices. The service waits until it is paid.

A relay whose plan sends 100,000 emails a month or more can take a dedicated sending address. Each one is a service of its own, with its own invoice (Dedicated sending addresses).

1. Open the relay's panel from Mail Services and stay on the Overview tab.
2. On the Sending IPs card, select Order dedicated IP. On a smaller plan the button is greyed out, and the card says which plan you need.
3. The Dedicated sending IP page opens with the relay chosen under Relay. If you opened the page another way, choose the relay there.
4. If This relay cannot take a dedicated IP yet appears, it names the smallest relay plan that can, with the emails it sends a month and its price. Select Change plan and move the relay to that plan or a larger one first. The button under the summary stays off until the relay can take the address.
5. Under Plan, choose the address's plan.
6. Check the summary, enter a promo code in Promo code if you have one, then select the button under it. It reads Place order when nothing is due. When you pay now it names the amount due, such as Pay $50.00 and order, and you pay on the same page as for any order.

When the address is ready, it is on the relay's Sending IPs card with an Add-on badge, and a Warming up badge while it warms up. Look for it there, on the relay's Overview tab.

Once account plans open on your account, your plan includes a Mail Hosting service and an SMTP Relay service at no charge, each sized to the plan (What each plan includes). You set up each one once, and there is nothing to pay.

1. In Mail Services, select Set up free email for Mail Hosting. With no mail service yet, it is a card in the middle of the page. For the SMTP Relay, open the More ways to get email menu and select Set up free SMTP Relay. Each leaves the page once you have that service. Both open a short page with the same form, at /dashboard/mail?setup=email and /dashboard/mail?setup=relay. The back link All mail services and Cancel return to the list.
2. Check the Your plan includes card beside the form. For Mail Hosting it gives your plan's Mailboxes, Storage per mailbox and Domains, and for SMTP Relay its Emails a month.
3. Optionally, enter a first domain in Domain (Mail Hosting) or Sending domain (SMTP Relay), such as example.com. You can also add it later, from the Domains tab.
4. Complete the verification check, if the page shows one.
5. Select Set up free email or Set up free SMTP Relay at the foot of the page. If we refuse the request, a Could not set up the email or Could not set up the SMTP Relay notice says why and the page keeps the domain you entered. Cancel goes back to Mail Services.

We set the service up and open its panel. Its header has an Included in your plan badge, and in Mail Services its card has no badge, and its Cost reads Included in your plan. It renews at $0, and we resize it when your plan changes (When your plan changes). The Plan and add-ons card on its Overview tab shows what the plan gives it, with Change plan… to choose another account plan.

Every service in the order appears in Mail Services with the status pending, then provisioning while we set it up, then active. We email you when each one is ready. Until then, its panel shows one of these:

• Waiting for payment, with Open invoices, until the invoice is paid. The service's card in the list says the same, with the same button, and the list's strip names it under Needs attention.
• Setting up while we create the service.
• Not set up yet on every tab but Billing, until the service exists.

When the service is active, the button at the top of the order's page opens its panel. If you entered a first domain, it is on the Domains tab as the primary domain, with the DNS records to publish. Continue with Add a domain to Mail Hosting or Add a sending domain.

The button under the summary is greyed out

The line under the button names the first answer still missing, such as Enter a valid domain, or leave it empty. or Complete the verification check. Select it to go to that section.

Enter a domain, such as example.com.

Type the domain on its own, such as example.com, with no https://, path or address. Or clear the field and add the domain later. On the SMTP Relay add-on, the line under the button reads Enter a domain for SMTP Relay, such as example.com, or leave it empty.

The verification check did not pass. Complete it and try again.

The check on a free order, or on the page that sets up the email your plan includes, expired or failed. Complete it again, then select Order for free, Set up free email or Set up free SMTP Relay again.

Complete the verification check to set it up.

You selected the button before the check finished. Complete the check, then select the button again.

Could not set up the email or Could not set up the SMTP Relay

We could not create the service your plan includes, and the line under the title says why. When it says the account already holds a free service of that kind, cancel that service first. Troubleshooting lists every reason.

You already have 1 free SMTP Relay. Upgrade or remove one to create another.

Each account may hold one free relay, and a free relay counts until it has ended. Order a paid plan instead, or cancel the free relay with Immediately and order again once it has ended (The free SMTP Relay plan).

This plan has no price yet.

The plan cannot be ordered yet. Choose another plan, or ask support.

Mail Hosting is not open for new orders yet. Try again later. or Mail Hosting has no capacity to set up a new service right now. Try again later.

Coritan cannot set up a new Mail Hosting service at the moment, and it refuses the order before it takes any payment. SMTP Relay gives the same two answers with its own name. Try again later. The API answers 422 with code set to out_of_stock, which also covers setting up the mail or sending service your plan includes. GET /availability says whether mail can be ordered now.

A plan shows Sold out

The plan cannot be ordered right now. Choose another plan.

Mail comes with your plan

Account plans are open on your account, so you no longer order Mail Hosting. Your account plan includes a Mail Hosting service instead: select Set up free email in Mail Services (Set up the email your plan includes).

No Mail Hosting plans on sale or No SMTP Relay plans on sale

Coritan does not sell the product to your account right now. Select Contact support if you expected it, or See all products to choose another product.

Could not load the plans

The plans did not load. Select Try again, or reload the page.

The first domain is not on the Domains tab

The order goes ahead even when the domain cannot be added, for example because it is already on another mail service. Add it from the Domains tab, which shows the reason if it is refused again.

No relays yet on the dedicated IP page

A dedicated IP sends for one of your relays, and the account has no active or suspended relay. Select Order SMTP Relay to order one first.

This relay is too small. Change its plan first.

The relay's plan sends fewer than 100,000 emails a month. Select Change plan under This relay cannot take a dedicated IP yet, move to the plan the message names or a larger one, then order the address.

Could not check the relay. Reload the page and try again.

We could not read the relay's plan. Reload the page. If Could not load your relays appears instead, reload the page too.

• Mail DNS records
• How Mail Hosting and SMTP Relay are billed
• How SMTP Relay sending limits work
• Order a service
• Claim a free coritan.gg name

Order either product with POST /services/order. List the plans with GET /products/: Mail Hosting plans have the module_name mail, and SMTP Relay plans smtp_relay. Copy the plan's config_schema into config as it is, and add domain for a first domain. We refuse a Mail Hosting order without the plan's mailboxes and storage_gb_per_mailbox, and a relay order without its monthly_messages.

This example orders Mail Hosting with an SMTP Relay on the same invoice:

curl -X POST https://api.coritan.com/api/v1/services/order \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": 61,
    "pricing_id": 140,
    "hostname": "example.com",
    "config": {"mailboxes": 5, "storage_gb_per_mailbox": 10, "domains": 1, "domain": "example.com"},
    "addons": [
      {
        "product_id": 72,
        "config": {"monthly_messages": 25000, "domains": 0, "credentials": 0, "dedicated_ips": 0, "quota_buffer_pct": 12, "domain": "send.example.com"}
      }
    ]
  }'

hostname is the name the service is listed under, and the dashboard sends the first domain there. An add-on needs a price above $0, so the free relay plan is ordered on its own, with a turnstile_token from the verification check on the website. Once account plans open on your account, Coritan refuses orders for Mail Hosting and the free relay plan with 422, and POST /account/included/{kind} sets them up instead (Set up the services your plan includes). The answer is 201 with the new service, its addons, and invoice_id and amount_due when requires_payment is true. Order a service describes the answer and the errors every order shares. These are the mail ones:

• 422 with {"detail": {"errors": [...]}} for a config we cannot use, such as mailboxes must be at least 1 or monthly_messages must be at least 1000. An add-on's message starts with its plan name.
• 409 with "error": "free_limit_reached" when the account already holds a free relay.

A dedicated sending IP is an order of the smtp_relay product whose config_schema has "addon": "dedicated_ip". Send that config_schema with relay_service_id, the service id of the relay it sends for. It cannot be an add-on of another order. Check the relay first with GET /client/smtp-relay/{service_id}: limits.dedicated_ip_addon_eligible must be true. We check the plan again when we set the address up, and the setup fails on a relay that sends fewer than limits.dedicated_ip_min_monthly emails a month.

curl -X POST https://api.coritan.com/api/v1/services/order \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"product_id": 79, "pricing_id": 160, "config": {"addon": "dedicated_ip", "dedicated_ips": 1, "relay_service_id": 1187}}'