LinkedIn

Overview

Connect your users to LinkedIn for professional profile data, social posting, and organizational content.

Property	Value
Provider ID	linkedin
Category	Social
PKCE	Not supported
Token refresh	Automatic
Redirect URI	Shown in Developer Portal

Step 1: Create a LinkedIn OAuth App

Go to the LinkedIn Developer Portal

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

Create a new app

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

Configure the redirect URI

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

Get credentials

Copy the Client ID and Client Secret from the Auth tab.

Warning

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

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add LinkedIn provider

Go to OAuth Providers > Add Provider > LinkedIn.

Enter credentials

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

Select scopes

Choose the scopes the application needs.

Save

Click Save. The provider is now active.

Available Scopes

Scope	Description
openid	Authenticate with LinkedIn using OpenID Connect
profile	View the user’s basic profile information
email	View the user’s primary email address
w_member_social	Post, comment, and like posts on behalf of the authenticated member
w_member_social_feed	Create, modify, and delete comments and reactions on the member’s behalf
r_organization_social	Retrieve organization posts, comments, likes, and engagement data
r_organization_social_feed	Read social actions for organizations the member administers
w_organization_social	Post, comment, and like posts on behalf of an organization the member administers
w_organization_social_feed	Manage social actions for organizations the member administers
r_organization_admin	Retrieve organization pages and reporting data including follower, visitor, and content analytics
rw_organization_admin	Manage organization pages and retrieve reporting data (administrator role required)
r_organization_followers	Use organization follower data to enable mentions in posts
r_1st_connections_size	Retrieve the count of the authenticated member’s 1st-degree connections
r_member_postAnalytics	Retrieve analytics for the member’s posts (impressions, reactions, comments, shares)
r_member_profileAnalytics	Retrieve the member’s profile analytics (viewers, followers, search appearances)

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.
• Community Management / Marketing API scopes (e.g., w_member_social, w_organization_social, r_organization_social) require LinkedIn product access approval. Apply in the Products tab of the app.
• See the LinkedIn OAuth 2.0 documentation for more details.

Policy-cataloged operations

Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.

Operation ID	Families	Method	Provider path
posts/create	send	POST	/rest/posts
ugc-posts/create	send	POST	/v2/ugcPosts
social-actions/comments/create	send	POST	/v2/socialActions/{shareUrn}/comments
posts/delete	delete	DELETE	/rest/posts/{postUrn}
reactions/create	write	POST	/rest/reactions
images/initialize-upload	write	POST	/rest/images
videos/initialize-upload	write	POST	/rest/videos
posts/get	read	GET	/rest/posts/{postUrn}
posts/list-by-author	read	GET	/rest/posts
social-actions/comments/list	read	GET	/v2/socialActions/{shareUrn}/comments
me/get	read	GET	/v2/me
userinfo/get	read	GET	/v2/userinfo
organizations/get	read	GET	/rest/organizations/{organizationId}
organization-acls/list	read	GET	/v2/organizationAcls
org-share-statistics/list	read	GET	/rest/organizationalEntityShareStatistics