Log in with Indeed

Use Indeed-provided images to create Log In with Indeed buttons.

 

legal notice

By using this API and its documentation and building an integration, you agree to the Additional API Terms and Guidelines.

Enable users to log in with Indeed credentials

To enable users to log in to your website with their Indeed credentials, complete these steps:

#	Step
1.	Construct a Log in with Indeed button.
2.	Authorize your app and authenticate the user.
3.	Get the ID of the logged-in user.

Construct a Log in with Indeed button

Use one of these button images to construct a Log in with Indeed button:

Name	Light background	Dark background
Default
Hover
Pressed
Focused
Disabled

Authorize your app and authenticate the user

Have the user authorize your app, then get an access token that authenticates the user.

1. Link the Log In with Indeed button to the Indeed https://secure.indeed.com/oauth/v2/authorize endpoint.

   For example:

   <a href="https://secure.indeed.com/oauth/v2/authorize?client_id=6nwwcdklwgktryjw2j5fxh5t2fyneule7zg7mvw3pf9jbx3wmewzlxkdz1jxvt7c&redirect_uri=http%3A%2F%2Fwww.acerecruitersllc.com%2Fgotcode.html&response_type=code&state=employer1234&scope=email+offline_access+employer_access"><img src="indeed-button.png" alt="default light"/></a>

2. When the user clicks Log In with Indeed, Indeed shows the OAuth consent screen to them. If they select Allow, Indeed passes an authorization code to the redirect_uri with the code and state response fields appended. See Response fields for oauth/v2/authorize.

3. Capture the code parameter from the redirect_uri page. For example:

   GET http://www.acerecruitersllc.com/oauth/indeed?code=rXZSMNyYQHQ&state=employer1234

   See also Prevent the authorization code from leaking.

4. Exchange the authorization code for an access token. See Get 3-legged access token.

5. Use this access token to make API calls on behalf of the user.

Get the ID of the logged-in user

After the user authorizes your app, get the unique job seeker ID.

1. Pass the access token to the v2/api/userinfo endpoint.

   For details, see The userinfo endpoint.

   This example request queries the user's account key and email address:

   GET /v2/api/userinfo HTTP/1.1
   Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
   Host: secure.indeed.com

   The response shows the user's account key and email address:

   HTTP/1.1 200 OK
   Content-Type: application/json
   
   {
     "sub": "248289761001",
     "email": "mina.ray@myemail.world",
     "email_verified": true
   }

   See Response fields for v2/api/userinfo.

2. Use this information to identify the logged-in user.