Skip to content

How to Integrate Zoho with PartnerPortal

Use this guide to connect Zoho CRM to PartnerPortal, understand how sync flows work, choose the Zoho pipeline you want to use, and control how partner-visible deal stages map back to Zoho. (Still comparing tools? See how PartnerPortal stacks up in our guide to the best PRM for Zoho.)

  • Admin access to PartnerPortal
  • Access to the Zoho account you want to connect
  1. Open Integrations from the PartnerPortal sidebar.

  2. Click Enable Zoho.

  3. Sign in to Zoho or approve the connection if you are already signed in.

  4. After the connection succeeds, click Settings on the Zoho integration.

  5. Click Configure to open the mapping screen.

If Zoho asks you to reconnect, use the Reauthorize action from the integration settings instead of disconnecting and reconnecting from scratch.

When a lead is approved in PartnerPortal, the integration creates the mapped Zoho CRM records and sends the portal data into those records based on your configuration.

For each newly connected lead, PartnerPortal creates exactly three linked Zoho-side records: the Deal, the associated person or contact record, and the associated company or organization record. After those records are linked, Zoho becomes the main source of truth for ongoing synced deal changes back into the portal.

Changes made in PartnerPortal do not sync back into Zoho. Zoho also does not support the separate Two-Way Sync setting that exists on the HubSpot integration.

Every new synced Zoho lead creates those same three records: a Deal, its related person or contact record, and its related company or organization record. The mapping screen controls how those records are populated and which pipeline and stages partners can see.

  1. In the configuration screen, find the Pipeline card under the Deal object.

  2. Open the card.

  3. Choose the Zoho pipeline you want PartnerPortal to sync.

The Zoho Pipeline card with a pipeline selected from the Value dropdown.

  1. Open the Stage card.

  2. Click Map Values.

  3. Map each PartnerPortal phase to the Zoho stage that should represent it.

  4. In On Create, set Zoho CRM Stage to, choose how new deals from PartnerPortal should enter Zoho:

    • Static stage: every new deal starts in the same Zoho stage
    • Infer from mappings: PartnerPortal chooses the starting Zoho stage from your phase mappings
    • Map manually: you choose the exact starting stage for each portal phase
  5. Save the Stage card.

If you want to sync more than one Zoho pipeline, use the selector on the left side of the stage-mapping window and repeat the mapping for each extra pipeline.

The Zoho stage-mapping window with the pipeline selector on the left.

Click Save mappings at the bottom of the configuration page when you are done. The Zoho integration will start syncing deals using the pipeline and stage rules you configured above.

If you also need more lead fields available to map into Zoho, update your lead registration form first so those values exist on the PartnerPortal side.

These settings live below the mapping interface on the Zoho CRM configuration screen.

Zoho works best when Deal remains the primary object. That keeps the linked record in PartnerPortal centered on the deal while still creating the related company and contact records alongside it.

This setting controls what PartnerPortal should do if Zoho CRM says the record already exists.

OptionWhat happens
ErrorPartnerPortal stops the create action and returns an error when Zoho CRM detects a duplicate
AdoptPartnerPortal uses the existing Zoho CRM record and continues tracking it

This setting controls what happens if one part of the multi-object create flow fails.

OptionWhat happens
Don’t CleanupObjects created earlier in the flow stay in Zoho CRM even if a later object fails
CleanupPartnerPortal deletes the records it created in that flow if a later object fails to create