# Zoho Field Mapping

To start setting up your field mappings click into the Contacts field tab in your integration settings.

<figure><img src="https://3940976487-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhZY7WR46v9ngHXb5FbhZ%2Fuploads%2Fuq9K948iefeyd0mQSd2P%2FScreenshot%202026-02-11%20at%204.51.37%E2%80%AFPM.png?alt=media&#x26;token=bdd9422b-40b9-4132-9ff5-dc23895658d7" alt=""><figcaption></figcaption></figure>

The following are the default Lead mappings. You can customize these mappings to include lead qualifiers and enriched data.

| Popl Field | Zoho Field |
| ---------- | ---------- |
| First Name | First Name |
| Last Name  | Last Name  |
| Email      | Email      |
| Number     | Phone      |
| Company    | Company    |
| Website    | Website    |

***

#### Customize your Field Mappings

You can modify or replace the default mappings with your own custom mappings. This includes Popl default fields, enriched data, and leads qualifiers. To add a new field mapping, click **Add Mapping** in the top-right corner of the Lead field mapping tab.&#x20;

<figure><img src="https://3940976487-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhZY7WR46v9ngHXb5FbhZ%2Fuploads%2FJMbYQbwMc5kVd4oj2Gx6%2FScreenshot%202026-02-11%20at%204.49.28%E2%80%AFPM.png?alt=media&#x26;token=b538a074-4716-4618-82bc-97c25fcbfe2a" alt=""><figcaption></figcaption></figure>

***

#### **Sync Logic For Leads**

After choosing which fields you want to map, you can adjust the sync behavior. You can choose between overwrite, complete if missing, or append.

**Overwrite field:** If a value already exists for an object in Zoho, replace that data with the Popl field.

**Complete if missing:** Only use the Popl value if the existing field is empty. Otherwise leave the field value as is in Zoho.

**Append:** Add Popl values to fields that may already have data, instead of replacing it.

***

#### **Mapping Types**

**Dynamic Mappings** – Dynamic mappings send real-time data from each individual lead into the corresponding Zoho field. The synced value updates based on the information captured during the lead exchange, including any lead qualifiers selected. Use dynamic mappings when Zoho fields should vary per record.

**Fixed Mappings** – Fixed mappings send the same predefined value to a Zoho field for every synced lead. This also applies to lead qualifiers, which can be set to pass a constant value if needed. To create a fixed mapping, click into the Popl field, select **Fixed Mapping**, and enter the value you’d like applied to all synced leads. Use fixed mappings when a consistent value is required across all records.

<figure><img src="https://3940976487-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhZY7WR46v9ngHXb5FbhZ%2Fuploads%2FFnkHH3vzSyKmFduYKxnm%2FScreenshot%202026-02-11%20at%205.05.13%E2%80%AFPM.png?alt=media&#x26;token=88526116-0c3f-4747-ba3c-3285d203bf15" alt=""><figcaption></figcaption></figure>

***

#### **Save Settings**

Once you have configured your field mappings, be sure to save your changes. You can do this by clicking **Save** in the top-right corner of the lead mapping tab.

<figure><img src="https://3940976487-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhZY7WR46v9ngHXb5FbhZ%2Fuploads%2F6jGeTByGiTitHLLsWzhr%2FScreenshot%202026-02-11%20at%205.06.52%E2%80%AFPM.png?alt=media&#x26;token=aa0984c7-482d-448e-a297-ca6f5856e9e9" alt=""><figcaption></figcaption></figure>

Once your mappings and sync behaviors are set, your integration runs seamlessly, automatically delivering the right data to the right Zoho fields every time.

***

#### **Need Help?**

Contact Popl Support – our team is available to assist at <teams@popl.co>.

With 🤍 from Popl.