Documentation Knowledgebase

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

Zoho Connector

Test your Zoho CRM connection

Run Test connection in the Zoho Connector to confirm Zoho accepts the saved credentials, data center, and environment. Includes an ordered checklist for failures and explains why verification applies only to the current session.

Updated

The test is the quickest way to find out whether the website can actually communicate with Zoho CRM. A connection that is merely saved has not yet proved that it works.

Why this matters

Testing protects you from discovering a broken connection later, when a customer record or membership update is expected to be processed. It also confirms that the credentials belong to the selected data center and environment.

Who this is for

A business owner, office manager, or website administrator can run the test. If it fails, the person who manages the Zoho OAuth client may need to correct the credentials or permissions.

Run the test

  1. Save the connection details.
  2. Select Test connection.
  3. Wait for the result.
  4. Look for Zoho CRM connection succeeded.
  5. Confirm Connection verified this session.

The verification badge applies to the current session. If you return later, test again before running a setup action that requires verification.

If the test fails

Check these items in order:

  1. The data center matches the Zoho account.
  2. Production, Sandbox, or Developer matches the OAuth client.
  3. The client ID is correct.
  4. The secret and refresh token are current.
  5. The selected scopes were granted to the client.
  6. The service URLs match the data center.
  7. The redirect URI is correct when your OAuth flow uses one.

Save the corrected settings and test again.

FAQs

Does a successful save mean the connection works?

No. Saving stores the settings. Testing checks whether Zoho accepts and can use them.

Why does the page say verified this session?

The test confirms access for the current visit. This wording encourages you to test again after returning later.

What should I do if the token is expired?

Ask the Zoho administrator to generate or authorize a current refresh token, then save and test the connection again.

Can I test without saving?

The form can test the values you submit, but saving first gives you a known starting point and keeps the configuration available for future use.

Who should troubleshoot a failed test?

Start with the person who manages the Zoho OAuth client. They can confirm the client, scopes, environment, and token without exposing secrets to everyone else.