Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.alterauth.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Connect your users to LinkedIn for professional profile data, social posting, and organizational content.
PropertyValue
Provider IDlinkedin
CategorySocial
PKCESupported
Token refreshAutomatic
Redirect URIShown in Developer Portal

​
Step 1: Create a LinkedIn OAuth App

1

Go to the LinkedIn Developer Portal

Navigate to linkedin.com/developers/apps and sign in.
2

Create a new app

Click Create app, fill in the app name, associate it with a LinkedIn Page, and upload a logo.
3

Configure the redirect URI

Under the Auth tab, add the Alter callback URL from the Developer Portal to Authorized redirect URLs for your app.
4

Get your credentials

Copy the Client ID and Client Secret from the Auth tab.
Never share your Client Secret publicly. Store it securely and only enter it in the Alter Vault Developer Portal.

​
Step 2: Add to Alter Vault

1

Open the Developer Portal

Go to portal.alterauth.com and navigate to your app.
2

Add LinkedIn provider

Go to OAuth Providers > Add Provider > LinkedIn.
3

Enter credentials

  • Client ID: Paste your LinkedIn Client ID
  • Client Secret: Paste your LinkedIn Client Secret
4

Select scopes

Choose the scopes your app needs.
5

Save

Click Save. The provider is now active.

​
Available Scopes

ScopeDescription
openidOpenID Connect authentication
profileAccess to profile name, photo, and headline
emailAccess to primary email address
w_member_socialPost, comment, and like on behalf of member
r_organization_socialRead organizational posts and statistics

​
Notes

  • LinkedIn now uses OpenID Connect for member authentication. Use openid, profile, and email rather than the deprecated r_liteprofile and r_emailaddress scopes — apps created after August 1, 2023 (when “Sign In with LinkedIn using OpenID Connect” replaced the legacy product) reject those legacy scopes with unauthorized_scope.
  • LinkedIn requires requesting product access for some scopes (e.g., r_organization_social). Apply in the Products tab of the app.
  • See the LinkedIn OAuth 2.0 documentation for more details.