Documentation Knowledgebase

This area helps us show you how to use our features to grow your business.

Zoho Connector

Upendo Zoho Connector

The Upendo Zoho Connector links a runsonUpendo website to Zoho CRM, tests the connection, prepares Leads and Contacts for Website Membership, and updates matching records on a schedule. Covers roles, setup, statuses, security, and troubleshooting.

Updated

What this module does

The Upendo Zoho Connector connects a runsonUpendo website to Zoho CRM. It can check the connection, prepare Zoho Leads and Contacts for Website Membership information, and update matching CRM records on a schedule.

The website remains the place where memberships and website roles are managed. Zoho CRM receives a readable summary of those membership roles so staff can understand the customer relationship while working in the CRM.

Who should use this module

This module is for trusted staff. It handles private CRM credentials and can change Zoho CRM field and layout settings.

  • Superusers: Can save and test the connection, configure Website Membership support, and enable the scheduled synchronization job. Only a superuser can enable the scheduler from this module.

  • Site administrators and approved CRM administrators: Can view the connection status and, when they have Edit permission on the module, save settings, test the connection, clear settings, and prepare Website Membership support.

  • Operations staff: Can review connection status, membership readiness, and scheduler status when they have View permission.

  • General content editors: Usually do not need this module. They can continue managing website content and membership roles in the normal site tools.

  • Website visitors and members: Do not use this module. They only experience the website. Their approved website membership roles may later appear in a matching Zoho Lead or Contact.

Before you begin

  1. Confirm that your organization has a Zoho CRM account and that your Zoho edition supports the needed CRM and settings actions.

  2. Ask a Zoho administrator to create or provide the OAuth client details.

  3. Generate a Zoho refresh token for the correct Zoho account, region, and scopes.

  4. Confirm that the web server can reach the Zoho accounts and API URLs.

  5. Back up or record the current Zoho field and layout settings before using automatic Website Membership setup.

  6. Never send the client secret or refresh token through email, screenshots, tickets, or chat.

Quick connection setup

  1. Open the Upendo Zoho Connector on the target website.

  2. Choose the Zoho Data Center and Environment.

  3. Select the OAuth scopes required by your approved CRM plan.

  4. Enter the Client ID, Client Secret, and Refresh Token.

  5. Enter the Redirect URI when your Zoho OAuth client requires one.

  6. Check the account and API service URLs. The default URLs are normally correct for the selected region.

  7. Select Save Connection.

  8. Select Test Connection and wait for the result.

The page shows separate status badges for connection setup, synchronization, and verification. A saved connection is not the same as a verified connection. Test it before enabling scheduled work.

Website Membership support

The connector checks the Zoho Leads and Contacts modules for the Website Membership field and section.

The status can show:

  • Available: The needed setup is present or ready.

  • Manual setup required: Zoho permissions, scopes, edition limits, or another setting prevented automatic setup.

  • Unsupported: The Zoho edition or API does not support the needed action.

  • Error: The connector could not finish the check.

When the connection is verified, Set Up Website Membership can create or complete the needed field and layout settings. This action changes Zoho CRM configuration. Review the result for both Leads and Contacts, and use a Zoho administrator when manual changes are required.

Scheduled synchronization

The scheduled job finds website users with email addresses, matches them to Zoho Leads and Contacts by email, and writes a readable Website Membership summary to matching records.

The summary can include:

  • the website roles that are treated as membership roles;

  • whether each role is active;

  • effective and expiration dates when available.

Built-in website roles such as Administrators, Registered Users, Subscribers, and Unverified Users are not treated as Website Membership roles. Translator roles are also excluded.

The job processes users in batches and remembers its position between runs. It updates matching records; it does not create a Zoho record for every website user. A user without a matching Lead or Contact is not added automatically by this connector.

Only a superuser can select Enable Synchronization in this module. After enabling it, review the website scheduler history. A successful connection test does not prove that a scheduled job has run successfully.

Common status meanings

Status or resultMeaningConnection not configuredRequired saved values are missing.Connection configuredThe connector has saved values, but they may not have passed a live test.Connection verifiedThe last connection test succeeded. Test again after changing credentials or URLs.Synchronization disabledThe scheduler is not enabled by this connector.Membership setup requiredZoho is missing the field or layout, or the account lacks permission to create it.No membership rolesThe website user has no qualifying Website Membership roles.Record not updatedThe email did not match a Zoho Lead or Contact, or Zoho rejected the update.

Security and data rules

  • Treat the client secret and refresh token as passwords.

  • Use the smallest approved OAuth scope set that supports the required work.

  • Keep the connector page restricted to trusted administrators.

  • The connector works at the current website level. Confirm the portal before saving settings.

  • Do not assume that changing the form and leaving without saving changes the stored connection.

  • If you clear the connection, the stored Zoho connection settings for the current portal are removed. This does not delete Zoho CRM records.

Troubleshooting path

  1. Read the exact message shown by the connector.

  2. Confirm the Data Center, Environment, Accounts URL, and API URL.

  3. Confirm that the OAuth client belongs to the same Zoho region and account.

  4. Confirm the refresh token is still valid and has the required scopes.

  5. Save the corrected settings and test the connection again.

  6. Check Website Membership status and resolve any manual setup message in Zoho.

  7. If synchronization is enabled, open the website scheduler history and review the latest run.

  8. Share status messages and timestamps with support, but never share secrets.

What success looks like

The connection is saved and verified, Website Membership support is available for Leads and Contacts, the scheduler is enabled by an authorized superuser, and the scheduler history shows successful runs. Matching CRM records then show current website membership information after the next successful synchronization.