LinkedIn

​

Overview

​

Capabilities

​

LinkedIn member (linkedin)

​

LinkedIn organization page (linkedin_page, beta)

​

Authentication

1. Call the connect endpoint with platform=linkedin.
2. Redirect the user to the returned auth_url.
3. LinkedIn redirects back to your redirect_uri with a code.
4. The code is exchanged for an access token automatically.

​

Scopes

• openid, profile — identify the member (used to read the person’s name, picture, and ID)
• w_member_social — publish posts as the member

​

Token lifetime

​

Required header

​

Connecting an account

curl -X POST https://api.social-api.ai/v1/accounts/connect \
  -H "Authorization: Bearer $SOCIALAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform": "linkedin", "redirect_uri": "https://yourapp.com/callback"}'

​

Publishing a post

curl -X POST https://api.social-api.ai/v1/posts \
  -H "Authorization: Bearer $SOCIALAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "targets": [{ "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J" }],
    "text": "Hello from SocialAPI!",
    "media_ids": ["f47ac10b-58cc-4372-a567-0e02b2c3d479"]
  }'

​

LinkedIn organization pages (beta)

​

Connecting an organization page

curl -X POST https://api.social-api.ai/v1/accounts/connect \
  -H "Authorization: Bearer $SOCIALAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "linkedin_page",
    "redirect_uri": "https://yourapp.com/callback",
    "metadata": { "connection_type": "organization" }
  }'

​

Scopes

• r_organization_followers: read the company page’s follower statistics
• r_organization_social: read the page’s posts and comments
• rw_organization_admin: read and write page administrative data (manage the page)
• r_organization_social_feed: read the page’s social feed
• w_organization_social: publish posts as the page
• w_organization_social_feed: create comments and replies on the page’s feed
• r_basicprofile: resolve the connecting admin’s identity via /v2/me

​

Organization URN requirement

​

Capabilities

​

Quirks and limitations

• LinkedIn member (linkedin) connects as the individual member. Use linkedin_page for organization pages.
• Reading a member’s own posts from the platform requires elevated permissions and is not available, so listing posts returns the posts SocialAPI has stored, not a live read from LinkedIn.
• Comments, direct messages, reviews, and mentions are not available for member accounts. Use the linkedin_page connector for organization page comment management.
• LinkedIn does not scrape link previews; provide your own thumbnail, title, and description for article posts.
• The post URN is returned in a response header, not the body.
• Member access tokens last about 60 days with no programmatic refresh; the member reconnects when the token expires.
• LinkedIn does not provide a token revocation API; disconnecting removes the stored token on our side only.

​

Next steps