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
- Save the connection details.
- Select Test connection.
- Wait for the result.
- Look for Zoho CRM connection succeeded.
- 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:
- The data center matches the Zoho account.
- Production, Sandbox, or Developer matches the OAuth client.
- The client ID is correct.
- The secret and refresh token are current.
- The selected scopes were granted to the client.
- The service URLs match the data center.
- 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.