LinkedIn Setup
Configure LinkedIn integration through the LinkedIn Developer Portal.
Prerequisites
- LinkedIn account
- Company Page (for page posting)
- Approved developer app
API Products
LinkedIn requires specific API products to be added to your app:
| Product | Purpose |
|---|---|
| Share on LinkedIn | Post content to member profiles |
| Sign In with LinkedIn using OpenID Connect | OAuth authentication |
| Marketing Developer Platform (MDP) | Post to Company Pages, analytics |
IMPORTANT
Marketing Developer Platform requires manual approval from LinkedIn and may take 2-4 weeks.
Required Scopes
Member Posting
| Scope | Purpose |
|---|---|
openid | OIDC authentication |
profile | Basic profile info |
email | Email address |
w_member_social | Post on behalf of member |
Company Page Posting (MDP)
| Scope | Purpose |
|---|---|
w_organization_social | Post to company pages |
r_organization_social | Read company page posts |
rw_organization_admin | Manage organization |
Callback URLs
https://api.tendsocial.com/api/company/social-accounts/callback/LINKEDIN_PROFILE
https://api.tendsocial.com/api/company/social-accounts/callback/LINKEDIN_PAGESet in: LinkedIn Developer Portal → Your App → Auth → Authorized redirect URLs
The callback URI must match the redirect_uri passed to LinkedIn during authorization and token exchange. In production, set OAUTH_REDIRECT_BASE_URL=https://api.tendsocial.com so callback exchange uses the same URI registered in LinkedIn.
Approval Strategy
Request member posting first with openid, profile, email, and w_member_social. Request Company Page posting separately after the app has Marketing Developer Platform access, because organization scopes are available only when LinkedIn has approved the required product access for the app.
Environment Variables
LINKEDIN_CLIENT_ID=your_client_id
LINKEDIN_CLIENT_SECRET=your_client_secretPlatform Limitations
| Feature | Status |
|---|---|
| Text posts | ✅ Supported (3,000 chars) |
| Images | ✅ Up to 9 images |
| Videos | ✅ Supported |
| Documents/PDFs | ✅ Supported |
| Polls | ❌ Not available via API |
| Articles | ❌ Not available via API |
| Comments | ✅ Read/write supported |
| Analytics | ✅ Via MDP |
Member vs Company Page Posting
| Type | Required Product | Scope |
|---|---|---|
| Personal profile | Share on LinkedIn | w_member_social |
| Company page | Marketing Developer Platform | w_organization_social |
Token Expiration
- Access tokens: 60 days
- Refresh tokens: not currently used by the TendSocial LinkedIn adapters
TendSocial currently requires LinkedIn accounts to reconnect when access tokens expire.
MDP Application Process
To get Marketing Developer Platform access:
- Create app in LinkedIn Developer Portal
- Request access to Marketing Developer Platform
- Complete questionnaire about your use case
- Wait for manual review (2-4 weeks)
- Once approved, add MDP scopes to your OAuth flow