Sign In with LinkedIn

  • Article
  • 2 minutes to read

Overview

With more than 500 million members worldwide, LinkedIn is the largest and well-nigh trusted source of professional identities. Leverage this power to enhance the sign-in experience of your sites and applications.

Employ Sign In with LinkedIn to:

  • Reduce friction and obtain more sign-ups by assuasive members to Sign In with LinkedIn, without having the need to create a new business relationship.
  • Minimize the costs and fourth dimension associated with implementing your ain login, identity, profile management, and countersign management.
  • Personalize your sites and applications with the latest member profiles.

Getting Started

Authenticating Members

New members logging in to your service for the beginning time will need to follow the Authenticating with OAuth 2.0 Guide. When requesting an potency lawmaking in Pace 2 of the OAuth ii.0 Guide, make sure to request the r_liteprofile and/or r_emailaddress scopes!

Permission Proper noun Clarification
r_liteprofile Required to retrieve the member's calorie-free contour including their id, name, and profile picture.
r_emailaddress Required to remember the member'south e-mail address.

After successful authentication, you will acquire an access token that tin exist used in the adjacent step of the sign-in process.

If your application does not have these permissions, you lot tin add them through the Developer Portal. Select your app from My Apps, navigate to the Products tab, and add the Sign in with LinkedIn production which volition grant you r_liteprofile and r_emailaddress.

Retrieving Member Profiles

With your newly acquired admission token for the authenticated member, you can use the post-obit API asking to think the member's profile information. See Lite Profile to learn more about the Calorie-free Profile fields available.

API Request

              Go https://api.linkedin.com/v2/me

Response Body Schema

Field Proper noun Clarification Format
ID The member's unique identifier Person URN
firstName Fellow member's starting time name Text
lastName Member's last name Text
profilePicture Member's profile picture URL Text

Sample API Response

              {    "id":"REDACTED",    "firstName":{       "localized":{          "en_US":"Tina"       },       "preferredLocale":{          "country":"U.s.a.",          "linguistic communication":"en"       }    },    "lastName":{       "localized":{          "en_US":"Belcher"       },       "preferredLocale":{          "country":"Us",          "language":"en"       }    },     "profilePicture": {         "displayImage": "urn:li:digitalmediaAsset:B54328XZFfe2134zTyq"     } }

With the member'due south profile information successfully retrieved, the sign-in process is at present complete and your user can keep to enjoy their personalized feel with your site or application.

Retrieving Fellow member Profile Motion-picture show

In club to recollect the member's profile picture, y'all will demand to use ornament. Apply the API request beneath to recollect the fellow member's id, first proper noun, last proper name, and profile flick.

              GET https://api.linkedin.com/v2/me?projection=(id,firstName,lastName,profilePicture(displayImage~:playableStreams))

Retrieving Member Email Accost

In addition to the member'south profile, y'all may be interested in retrieving the member's e-mail address. The r_emailaddress permission scope allows usage of the post-obit API:

API Request

              GET https://api.linkedin.com/v2/emailAddress?q=members&projection=(elements*(handle~))

Response Body Schema

Field Name Description Format
handle The URN representation of a member's handle. Email Accost URN

Sample API Response

              {     "handle": "urn:li:emailAddress:3775708763",     "handle~": {         "emailAddress": "hsimpson@linkedin.com"     } }

Boosted Resource

Image Resources

Sign in with LinkedIn

Download official Sign In with LinkedIn button images in multiple sizes and formats from the LinkedIn Brand Resource annal for use within your site or application.

Rate Limits

Throttle Type Daily Request Limit (UTC)
Member 500 Requests
Application 100,000 Requests