> ## Documentation Index
> Fetch the complete documentation index at: https://help-empuls.xoxoday.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Zoho

> Connect Zoho People for HR sync, Zoho CRM for sales recognition, or Zoho Mail — one OAuth flow, multiple Zoho products.

The Zoho integration covers multiple Zoho products from a single connection. Connect **Zoho People** to sync your employee directory; connect **Zoho CRM** to surface sales achievements as recognition events; connect **Zoho Mail** so Empuls notifications respect your Zoho mail policies. You authorize Empuls once and pick which Zoho products to enable.

## Before you start

* You must be a **Super Admin** in Empuls.
* You need a Zoho admin account with permission to authorize third-party apps for the Zoho products you want to connect.
* Decide upfront which Zoho products are in scope. You can add more later but each requires its own scope grant.

## Connect Zoho

<Steps>
  <Step title="Open the Zoho card">
    From the Integrations hub, click **Zoho** and then **Configure**.
  </Step>

  <Step title="Choose which Zoho products to connect">
    Check **Zoho People**, **Zoho CRM**, and/or **Zoho Mail**. Each product adds its own OAuth scopes to the consent step.
  </Step>

  <Step title="Authorize in Zoho">
    Empuls redirects to Zoho's OAuth consent screen with the combined scope set. Sign in with a Zoho admin and approve.
  </Step>

  <Step title="Configure each product">
    For each product you connected:

    * **Zoho People** — Confirm directory preview, map fields, run initial sync.
    * **Zoho CRM** — Pick which CRM events (closed-won deals, quota achievements) should generate recognition events in Empuls.
    * **Zoho Mail** — Verify the sender address Empuls should use; confirm DMARC/SPF on your Zoho domain.
  </Step>
</Steps>

## Zoho People sync

Same directory sync pattern as other HRIS connectors:

| Zoho People field | Empuls field           |
| ----------------- | ---------------------- |
| First / last name | First Name / Last Name |
| Email             | Email                  |
| Department        | Department             |
| Designation       | Designation            |
| Reporting manager | Reporting manager      |
| Status            | Active / Inactive      |

## Zoho CRM-driven recognition

When you enable the CRM connection, Empuls subscribes to selected CRM events. Each event creates a feed post and optionally awards reward points. Common configurations:

* **Closed-won deal** — Post celebration to the sales channel; award points to the deal owner.
* **Quarterly quota hit** — Public recognition post; configurable point value.
* **New customer signed** — Welcome celebration; no points by default.

Choose specific deal stages or dollar thresholds to filter which events generate recognition.

## Zoho Mail handoff

When you enable Zoho Mail, Empuls notifications are sent through your Zoho mail server using a designated sender address. This is useful when corporate mail policy requires all outbound mail to flow through Zoho.

## Reconnect or disconnect

Each Zoho product can be reconnected or disconnected independently from the Zoho integration page.

## Limits and gotchas

* Disconnecting Zoho People stops directory sync but does not deactivate already-imported users.
* Zoho CRM event subscriptions count against your CRM API quota. Use filters to avoid generating a recognition post for every deal-stage change.
* Zoho Mail requires your domain's DMARC/SPF records to whitelist Empuls — Empuls will surface the exact records you need to add.

## Related

<CardGroup cols={2}>
  <Card title="HRMS integration overview" href="/admin/integrations/hris-hrms">
    Connect and sync your HR system with Empuls.
  </Card>

  <Card title="Reward governance" href="/admin/programs/reward-governance">
    Set limits on automated CRM-driven recognition.
  </Card>

  <Card title="Awards & core values" href="/admin/programs/awards-core-values">
    Define the awards CRM events trigger.
  </Card>
</CardGroup>
