zoho-mail.md - is-a-dev-docs - is-a.dev Documentation

zoho-mail.md (4529B)
      1 ---
      2 order: 1550
      3 icon: /media/zohomail.svg
      4 label: Zoho Mail
      5 tags: guides
      6 ---
      7 
      8 # Setting up Zoho Mail using is-a.dev subdomain
      9 
     10 This guide will walk you through the process of setting up custom email in Zoho Mail with your is-a.dev subdomain.
     11 
     12 ## Getting Started
     13 
     14 ![](../media/zohomail/step_1.png)
     15 
     16 1. Visit the [Zoho Mail homepage](https://www.zoho.com/mail/), fill in the required details, and click **SIGN UP FOR FREE** to create your account. If you already have one, visit [here](https://www.zoho.com/mail/login.html) to login to your existing account.
     17 2. You must have an is-a.dev subdomain to set up and use Zoho Mail services. Learn more in our [GitHub repository](https://github.com/is-a-dev/register).
     18 3. A valid mobile number and an email address for verification purposes is **required** to access Zoho Mail.
     19 
     20 ## Verify your domain
     21 After logging in to your Zoho Mail account, follow the steps given to verify your domain ownership.
     22 
     23 1. Click **Add now** under the **Add an existing domain** section on the Domain Addition page.
     24 
     25    ![](../media/zohomail/step_2.png)
     26 
     27 2. Enter `your-domain.is-a.dev` subdomain and the name of your organization in the pop-up. The organization name can be your personal name too. Click **Add now** to proceed.
     28 
     29    ![](../media/zohomail/step_3.png)
     30 
     31 3. Once your domain is added, click **Proceed to payment**. If you want to skip this and continue with your free plan, then click **Change my plan**.
     32 
     33    ![](../media/zohomail/step_4.png)
     34 
     35 5. On Zoho's domain setup page, select **Add TXT record to DNS** from the dropdown. It is recommended, but you can also use the last HTML file option for quick setup.
     36 
     37    ![](../media/zohomail/step_5.png)
     38 
     39    You need to copy the **TXT value / content** and create a new file or update an existing file, for example `your-domain.json`. After that, please open a pull request in [our repository](https://github.com/is-a-dev/register) and **wait for the pull request to be merged**.
     40 
     41    ```json
     42    {
     43     "owner": {
     44         "username": "github-username"
     45      },
     46     "records": {
     47         "TXT": ["Paste TXT Value / Content Here"]
     48      }
     49    }
     50    ```
     51 
     52 6. Now that you have verified ownership of your domain, click **Create** to create your first email using your is-a.dev subdomain.
     53 
     54    ![](../media/zohomail/step_6.png)
     55 
     56 
     57 ## DNS Mapping
     58 
     59 After you verified your domain, you may see the **Setup Users** and **Setup Groups** sections, where you can set up your users (such as example@your-domain.is-a.dev) and groups. For now, you can skip these and move on to **DNS Mapping**.
     60 
     61 ### MX and SPF Records 
     62 
     63 1. Now you need to add the **MX** and **SPF records** for your domain. You will need to update the existing file that you used to verify the domain and add the TXT record.
     64 
     65    ![](../media/zohomail/step_7.png)
     66 
     67    Copy the **MX** values and **TXT** values for the SPF record and update your file. This is the most important step, please be careful.
     68 
     69   ```json
     70      {
     71       "owner": {
     72         "username": "github-username"
     73       },
     74       "records": {
     75         "TXT": [
     76           "TXT Value / Content Will Be Stay Here From Old Content",
     77           "v=spf1 include:zohomail.com ~all"
     78         ],
     79         "MX": [
     80           {
     81             "target": "mx.zoho.com",
     82             "priority": 10
     83           },
     84           {
     85             "target": "mx2.zoho.com",
     86             "priority": 20
     87           },
     88           {
     89             "target": "mx3.zoho.com",
     90             "priority": 50
     91           }
     92         ]
     93       }
     94     }
     95   ```
     96 !!! Double check if the Zoho domain is right. Zoho gives different domains to each region the user is located, like `zoho.eu` for Europe, `zoho.in` for India and so on.
     97 !!!
     98 
     99 ### DKIM Record
    100 
    101 2. Now only **DKIM record** is left, for this you have to create a **new file** named `zmail._domainkey.your-domain.json`. Please note that `your-domain` should be replaced with the is-a.dev subdomain that you own.
    102 
    103    Paste the following content in your `zmail._domainkey.your-domain.json` file:
    104 
    105    ```json
    106    {
    107      "owner": {
    108       "username": "github-username"
    109      },
    110     "records": {
    111       "TXT": "Paste the DKIM Value Here"
    112      }
    113    }
    114    ```
    115 
    116    After you have done all, please create a pull request in [our repository](https://github.com/is-a-dev/register) and wait for it to get merged.
    117 
    118 
    119 ## You're all set
    120 
    121 ![](../media/zohomail/step_8.png)
    122 
    123 After all your pull requests has been merged, you will see the same page as above, if you see it, you are all set and your email is now ready to use with the is-a.dev subdomain. Enjoy your custom email!