Skip to main content

Documentation Index

Fetch the complete documentation index at: https://empuls.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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. Open the integrations hub in your tenant at https://<your-empuls-url>/home/integrations and click Zoho.

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

1

Open the Zoho card

From the Integrations hub, click Zoho and then Configure.
2

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.
3

Authorize in Zoho

Empuls redirects to Zoho’s OAuth consent screen with the combined scope set. Sign in with a Zoho admin and approve.
4

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.

Zoho People sync

Same directory sync pattern as other HRIS connectors:
Zoho People fieldEmpuls field
First / last nameFirst Name / Last Name
EmailEmail
DepartmentDepartment
DesignationDesignation
Reporting managerReporting manager
StatusActive / 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.