Migrating to Oauth 2.0
This article will help you generate access and refresh tokens from the existing auth token for redirection based applications and self-client applications. You can use the API version 1.1 when:
- Your application has multiple users and it obtains their username and password to generate an auth token
- Users input their auth tokens
Migration for redirection based application
Prerequisite
The application owner must share the client ID, auth token scopes, and the required Oauth scopes over an email to support@zohocampaigns.com. At Zoho Campaigns, we will validate the details and configure them in Zoho Accounts. After successful validation, we will inform the application owner about the client upgrade over an email.
How it Works?
Migration for redirection based applications happens in a phased manner.
- After successful validation from the service team, the external application will access the "Migration for Redirection-based Applications" API with the client ID, client secret, and auth token.
- Zoho Accounts will check whether the parameters passed in the request are already verified.
- After successful validation, Zoho Accounts will provide the Oauth access and refresh tokens to the application.
Request URL
Request method
POST
Parameters
|
Parameter |
Data type |
Description |
|
client_id |
string |
Specify the client ID you obtained while registering your application |
|
client_secret |
string |
Specify the client secret generated from the connected application. |
|
grant_type |
string |
The grant type must be authtooauth. |
|
authtoken |
string |
Specify your auth for token.
|
Possible Errors
|
Error code |
Description |
|
invalid_grant |
The grant_type is not specified as authtooauth. |
|
invalid_client |
The client ID you specified is wrong.
(or)
The auth to Oauth mapping entry for the valid client is not made in accounts. |
|
invalid_authtoken |
The auth token you specified is wrong.
(or)
The auth token scope mismatches with the pre-shared auth scopes. |
|
invalid_scope |
The Oauth scope you specified is invalid. |
Note:
- The maximum number of migration requests you can make is 60 per minute and 100 per hour.
- After the generation of an Oauth token, the system deletes the old auth token after 1 day.
- The maximum number of times a client can pass an invalid auth token is 20. If you exceed this limit, the system will block the client and throw the "access_denied" error message.
Migration for self-client applications
You can use this option when your application is a standalone server-side application performing a back-end job, and you do not have a domain and a redirect URL.
How it Works?
Migration for self-client applications happens in a phased manner.
- The external application will access the "Migration for Self-Client Applications" API with the client ID, client secret, auth token, and the required Oauth scopes.
- Zoho Accounts will check whether the service names of the auth token and Oauth scopes match.
- After scope validation, Zoho Accounts will check whether the application owner and the auth token owner are the same.
- If the validation is successful, Zoho Accounts will generate an Oauth token for the external application. Otherwise, the system will throw the "access_denied" error message.
- Zoho Accounts will send an email to the user about the client upgrade.
Request URL
Request method
POST
Parameters
|
Parameter |
Data type |
Description |
|
client_id |
string |
Specify the client ID you obtained while registering your application. |
|
client_secret |
string |
Specify the client secret generated from the connected application. |
|
grant_type |
string |
The grant type must be authtooauth. |
|
authtoken |
string |
Specify your auth token. |
|
scope |
string |
Specify the Oauth scopes to access data from Zoho Campaigns. For more details about Zoho Campaign scopes, refer Access Token section of the Zoho Campaigns REST API Documentation. |
Possible Errors
|
Error code |
Description |
|
invalid_grant |
The grant_type is not specified as authtotoauth. |
|
access_denied |
The auth token you specified is already used to generate an Oauth token. |
|
invalid_client |
The client ID you specified is wrong. |
|
invalid_authtoken |
The auth token you specified is wrong. |
|
invalid_scope |
The Oauth scope you specified is invalid. |
Note:
- The maximum number of migration requests you can make is 25 per minute and 60 per hour.
- After the generation of an Oauth token, the system deletes the old auth token after one day.
Error Codes
The set of error codes with their values are explained in this link.
Access your files securely from anywhere
Zoho CRM Training Programs
Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.
Zoho DataPrep Personalized Demo
If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.
New to Zoho Survey?
Zoho Sheet Resources
Zoho Forms Resources
New to Zoho Sign?
Zoho Sign Resources
Sign, Paperless!
New to Zoho TeamInbox?
Zoho TeamInbox Resources
New to Zoho ZeptoMail?
Zoho DataPrep Resources
Design. Discuss. Deliver.
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
New to Bigin?
Related Articles
Migrating to Zoho Campaigns
Moving to a new email marketing platform is an exciting transition that promises better growth and conversions. However, the process of migration may be a daunting task for marketers as they will have to acclimatize to the UI, features, and ...Sender APIs
Sender APIs is the place where you can make use of an authentication mechanism to connect Zoho Campaigns Email API with your application and send emails using our APIs. We provide both REST API and SMTP API as methods of integration. Zoho Campaigns ...Why is my Zoho Recruit-Zoho Campaigns integration not migrated to the new OAuth setup?
This might happen due to one of the following reasons: Your ZSC key is invalid, so the migration couldn't take place. Re-integrate your account and check if you can access the syncs. You are not an admin in Zoho Campaigns. You need to change your ...Why can't I see the Topic Selection option after migrating to the new topic management model?
If you are using the default topic, Marketing, and haven't configured any other topic for your organization, then all contacts will be associated with that topic by default. This will not be reflected explicitly while adding contacts or creating ...Will the old syncs (in old CRM sync setup) be carried over or deleted after the migration deadline?
After migration, all the existing syncs will be removed. We suggest that the users create a new sync that matches their requirements before migrating to the new CRM sync setup model.
New to Zoho LandingPage?
Zoho LandingPage Resources