Email Parser | Online Help - Zoho CRM

Email Parser

For example, imagine you run a real estate business and have put your property details on a real estate portal. The potential buyers or tenants submit their details through the portal's website and user details are sent to you in an email. Instead of you manually entering the details in to the CRM, an email parser can retrieve the information from the email and add it as a record under the respective module (leads, contacts, accounts, or custom modules) in your CRM account.

Permission Required
Users with Administrative profile can create email parser.

Create and Configure Email Parser

Creating and configuring an Email Parser consists of the following steps:

Step 1. Create your email parser, select a parser name, and associate a module

You can create an email parser for leads, contacts, accounts and custom modules. Once you enter the parser name and choose the module to associate the parser to, a parser email address is generated.
You can create up to 20 email parsers, but only 10 parsers can be active in an org at any one time. 

Step 2. Configure parsing details

A template is an email in which you mention the data fields to be mapped to the respective CRM fields, if required you can change the data fields manually. Only the incoming emails that follow the provided template will be parsed.

There are two ways to create a template:

  1. Sending an email to the pre-parser address - You can send any email that you want to use as a template, to a pre-parser address. The email must contain the information about the data fields.
  2. Copying and pasting email content - You can copy and paste the content of any email that you want to be used as a template.
What are the types of parsing templates?

There are two types of template that you can use for parsing your data. You can use any of the templates as a parser but best practice is to use key-value pairs as this makes fetching data easier and simpler.

1. Key-value pair - A single detail like first name or email is the key and a reference to this key is called the value. In this type of template the key and the value are separated by a delimiter.
For example:
First name: Nicholas
Last name: Woods
Country: Canada
Here, the key is First name, Country and the value is Nicholas, Canada.

2. Paragraph format - A paragraph format does not contain any delimiter* or separator between the key and value format. Each sentence or paragraph that you enter is a data field that should be mapped with the corresponding CRM field.

For example: An apartment with 1,200 sqft area.  

This is a sentence without any delimiter. During parsing, this entire sentence will be treated as the data that needs to be mapped with a corresponding CRM field such as, Property Area.

*Delimiter - A delimiter is a character used to specify the beginning or the end of your data. A delimiter can be a colon, hyphen, or similar.

How is a parser email address generated?

The parser email address is auto generated by Zoho CRM once you configure a parser. All the emails that you want to be parsed must be sent to the parser email address.

Step 3. Send email to the parser email address

The email address from which forward the lead emails to the parser email address must be approved. You can either forward the emails from your email address or the vendor or real estate portal can add the parser email address in cc, when sending the lead emails to you. In both cases, the email addresses must first be approved to avoid errors.

Step 4. Update a CRM field

You can update fields for the records that will be created in the CRM using the parsing method. For example, you have set that all the records created via the parsing method are for a particular apartment. In this case, you can choose the apartment name be automatically updated once the records are added into the CRM.

Step 5. Assign record owner

Choose and assign a record owner for each record that is created by the email parsing method. You can select more than one user for these records and the user assignment will follow the round-robin method. You can also choose to assign these records to a particular role in your organization.

Please note that assigning a record owner is a mandatory step in configuring an email parser.

Step 6. Enter approved email address

Specify the email address(es) from which the emails will be sent to the parser email address. There are two options to send an email:

  • You can send the emails directly from your email address to the parser email address.
  • The real-estate portal can add the parser email address to the carbon copy column when sending the emails to you.

Note that you can not forward an email to the parser email address. 

To create your email parser, add a parser name and associate a module

  1. Go to Setup > Channels > Email.
  2. In the Email page, click Email Parser > Create Your First Email Parser.

    In the Create Your First Email Parser page, enter the Parser Name and choose a Module from the drop-down list.
  3. Click Next to continue.
    Next, you will have to create an email template for the parser either by sending an email or copying and pasting the content.

To configure by sending an email to the pre-parser address

  1. In the Give us the email contact to be used as template for parsing by section, select Sending an email from the drop-down list.
    A pre-parser email address will be generated (For example:
  2. Send an email to the pre-parser email address.
    You can send the content either in paragraph or key-value format.
  3. Click Click Here to generate the content inside CRM.
  4. Click Save.
  5. Click Next to continue.
    In the next step, you will update the CRM field.

To configure by copying and pasting email content

  1. In the Give us the email contact to be used as template for parsing by section, select Copy and pasting email content from the drop-down list.
  2. Paste the content to be used as the parsing template.
    You can paste the content either in paragraph or key-value format.
  3. Click Parse.
  4. Click on the content and choose the CRM data fields from the drop-down list to map the content to.
  5. Click Save.
  6. Click Next to continue.
    In the next step, you will update the CRM field.

  • You can use a pre-parser address only once. It is auto-generated and is a temporary email address that will be revoked.
  • After you paste the content to be parsed, click on How it Works to learn more about parsing. If you have used the key-value pair format, Zoho CRM will suggest the list of delimiters you can use.
  • You can also choose to change the content you have pasted using Change the Content option.
  • You can choose to add the email attachments to the CRM record that is created.

  • There can be instances when you receive an invalid email error, the possible reasons can be:
    • The content provided doesn't match with the content in the parser.
    • The provided data exceeds or doesn't match the mapped field. 
  1. In the Update Field option, select a CRM field from the drop-down list.
  2. Enter the corresponding data field value to be updated.
  3. Click the Add icon to add more fields.

  1. In the Assign Record Owner optiongo to Assign Based On and select either UsersRoles, or Assignment Rules from the drop-down list.
  2. Select the User from the drop-down list.
  3. Click Next to continue.
    In the next step, you need to enter the approved email addresses.

  1. In the Approved Email address field, specify the email address.
  2. Click the Add icon, to add more email address.
  3. Click Save.


    Zoho DataPrep Personalized Demo

    If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

    Zoho CRM Training

      Create, share, and deliver

      beautiful slides from anywhere.

      Get Started Now

              Zoho CRM Training Programs

              Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

              Zoho CRM Training

                Zoho SalesIQ Resources

                    Zoho TeamInbox Resources

                              Zoho DataPrep Resources

                                Zoho DataPrep Demo

                                Get a personalized demo or POC

                                REGISTER NOW

                                  Design. Discuss. Deliver.

                                  Create visually engaging stories with Zoho Show.

                                  Get Started Now

                                                        • Related Articles

                                                        • Troubleshooting Email Parser

                                                          1. The parser email is in the invalid email section. Reason The content in the email doesn't match the content of the parser The content in the email has different spacing or merges the characters in the same line This is the valid format for parser ...
                                                        • FAQs on Leads

                                                          1. How can I link a lead to a specific campaign? Follow these steps to link a lead to a specific campaign: In the Leads tab, select the record that you want to link to the campaign. In the Lead Details page, click Edit. Select the campaign from ...
                                                        • Creating Leads

                                                          In Zoho CRM, you can create leads by: Entering data in the lead details form: You can manually fill in the Lead details gathered from various external sources, e.g. trade shows, exhibitions, colleagues, business cards, etc. Importing leads from ...
                                                        • Converting Leads

                                                          When there is a chance for further negotiations with a lead, it can be converted into an account, contact, and finally a deal. In short, once the lead status has reached a certain stage, it can be qualified as a deal. On conversion, a lead is ...
                                                        • Understanding Email Template Builder

                                                          Components of Template Builder The template builder is made up of various components that can be dragged and dropped on to the template. This in turn simplifies the process of creating a template. The three basic operations that is common to all the ...



                                                        Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.


                                                        Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.


                                                        Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.

                                                        CRM Tips

                                                        Make the most of Zoho CRM with these useful tips.

                                                          Zoho Show Resources