Zoho Recruit | Using Authentication Token

Using Authentication Token

The Zoho Recruit API is available in all editions of Zoho Recruit. To use the API, you'll require the Zoho Recruit Authentication Token from your Recruit account. Please make sure that you have the permission to access the API service. If you do not have permission, please contact your Recruit administrator.

Generate Auth Token

To generate the Auth Token, you need to send an authentication request to Zoho Accounts using the URL format below.

Note: The user must be a confirmed user, else while generating the Auth Token the user will receive an error - "ACCOUNT_REGISTRATION_NOT_CONFIRMED".

URL Format

API Mode: https://accounts.zoho.com/apiauthtoken/create?SCOPE=ZohoRecruit/recruitapi&EMAIL_ID=Zoho Recruit Username or Email ID&PASSWORD=Your Zoho Recruit Password

Using Two-factor Authentication?

If you're using the two-factor authentication to access your Zoho Recruit account, follow these steps to generate the Auth Token in API mode:

  1. Log in to Zoho Recruit.
  2. Open https://accounts.zoho.com.
  3. In the Zoho Accounts Home page, click Two Factor Authentication.
  4. In the Two Factor Authentication page, click on the Manage Application Specific Passwords.
  5. In the Application Specific Passwords pop-up, specify these details:
    1. Device or App Name
    2. Current Password
    3. Click Generate.
      You will receive the new application-specific password with spaces.
  6. Remove the spaces in the password and include it in the below URL:

    https://accounts.zoho.com/apiauthtoken/nb/create?SCOPE=ZohoRecruit/recruitapi&EMAIL_ID=username&PASSWORD=application_password

Parameters to be passed along with this URL are:

Parameter
Description
EMAIL_ID
Specify your Zoho Recruit Username or Email ID
scope
Specify the value as ZohoRecruit/recruitapi
PASSWORD
Specify your Zoho Recruit Password

For more information, please refer Two-factor Authentication help page.

Browser Mode: Log in to Zoho Recruit in a new window and use the following URL:
 https://accounts.zoho.com/apiauthtoken/create?SCOPE=ZohoRecruit/recruitapi 
If you are a Google Apps User, you can log into your Recruit account and then use the browser mode format to generate the Authentication Token.

Sample Response


#
#Wed Feb 29 03:07:33 PST 2012
AUTHTOKEN=bad18eba1ff45jk7858b8ae88a77fa30
RESULT=TRUE

Note:

  1. The Auth Token can be used in all your API calls. You can also see the URL format under Setup > Developer Space Recruit API.
  2. You need to be logged into your Recruit account to use the Browser Mode.

Here's an example to fetch records:

https://recruit.zoho.com/recruit/private/xml/Candidates/getRecords?authtoken=7d987658943g4j09h43dd0b167dda34b&scope=recruitapi

Manage Auth Tokens

You can viewdelete and regenerate the Auth Token generated for your account from the 'My Zoho Account' Page.

  1. Log in to Zoho Recruit.
  2. Open [Username] > My Zoho Account.
  3. In the My Zoho Account page, click Settings > Active Authtokens.
    In this page, you can also Remove or Regenerate Auth Tokens.
Note:
Removing an Auth Token will delete the token permanently.
If you regenerate Auth Token, update your program with the new token.
Important Notes
  1. The Auth Token is user-specific and is a permanent token.
  2. On deletion, the existing token will be deleted permanently. The new token has to be replaced for all API calls.
  3. The Auth Token of a user's account will become invalid if the user is deactivated. 

    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 CRM Training

      Create, share, and deliver

      beautiful slides from anywhere.

      Get Started Now





              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 CRM Training

                Zoho SalesIQ Resources



                    Zoho TeamInbox Resources




                              Zoho DataPrep Resources

                                Zoho DataPrep Demo

                                Get a personalized demo or POC

                                REGISTER NOW


                                  Design. Discuss. Deliver.

                                  Create visually engaging stories with Zoho Show.

                                  Get Started Now











                                                        • Related Articles

                                                        • Email Authentication

                                                          In this digital era email forms a major part of communication in every business or organization. Companies often use different servers or domains other than their server to deliver the message to its recipients. In such cases it's crucial to ...
                                                        • Using Macros

                                                          Macros are a set of actions that can be executed for a group of records in a module. These sets of actions include sending emails, creating tasks, and updating a field in the records with a specified value. You may have a set of actions that you ...
                                                        • Using Territories

                                                          Understanding Territory Management Using Territory Management, you can segment clients, contacts, and job opening into territories. You can build a territory hierarchy by creating territories and sub territories. You can define criteria for each of ...
                                                        • Creating and Using Sandbox

                                                          As your organization grows, so does the complexity in your recruitment processes. At such a point, any small error in a process could cause a domino effect. To help overcome this trouble, Zoho Recruit brings to you the Sandbox, an environment to test ...
                                                        • Using BCC Dropbox

                                                          If you use multiple email accounts for your business, your email communication will be recorded in various email clients. You can combine all these business emails in your Zoho Recruit account using the BCC Dropbox feature. BCC Dropbox provides a ...

                                                        Resources

                                                        Videos

                                                        Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                        eBooks

                                                        Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                        Webinars

                                                        Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                        CRM Tips

                                                        Make the most of Zoho CRM with these useful tips.



                                                          Zoho Show Resources