📘 LinkedIn API Integration Guide for Stackposts

(Two-App Setup: Profile & Page)

This guide explains how to create and configure two separate LinkedIn Apps to connect Stackposts with both personal profiles and company pages for publishing and management.

---

🔹 Why Two Apps Are Required

LinkedIn separates access permissions for Profiles and Pages.
Each type requires a different set of scopes and product permissions:

Because rw_organization_admin is only available for apps verified with a LinkedIn Company Page, you must create two separate apps.

---

🧩 App #1 — LinkedIn Profile (Personal)

Used for connecting individual LinkedIn profiles.

Step 1: Create the App

1. Go to LinkedIn Developer Portal.

2. Log in → click Create App.

3. Fill in:

   • App Name: Stackposts LinkedIn Profile

   • LinkedIn Page: Leave blank (not required)

   • Privacy Policy URL: https://yourdomain.com/privacy-policy

   • Logo: square image (min 100×100 px)

4. Tick the agreement and click Create app.

---

Step 2: Enable Products

Under the Products tab, click Request Access for:

• ✅ Sign In with LinkedIn (OpenID Connect)

• ✅ Share on LinkedIn

---

Step 3: Configure Redirect URL

Go to Auth → OAuth 2.0 Settings and add:

(Replace yourdomain.com with your actual domain.)
Then click Save changes.

---

Step 4: Add App Credentials to Stackposts

In Stackposts Admin → API Integrations → LinkedIn:

• Paste your Client ID and Client Secret under LinkedIn Profile.

• Enable it and click Save changes.

---

Step 5: Required Scopes (Profile)

Use the following OAuth 2.0 scopes:

Explanation

• email → Access user’s email address

• profile → Read basic profile information

• openid → Authenticate the user identity

• w_member_social → Create and publish posts on behalf of the user

---

🧩 App #2 — LinkedIn Page (Company)

Used for connecting and managing LinkedIn Company Pages.

Step 1: Create the App

1. Visit LinkedIn Developer Portal.

2. Click Create App again.

3. Fill in:

   • App Name: Stackposts LinkedIn Page

   • LinkedIn Page: select your company page (required)

   • Privacy Policy URL: https://yourdomain.com/privacy-policy

   • Logo: square image (min 100×100 px)

4. Click Create app.

---

Step 2: Verify Your Company Page

• Open your new app → Settings tab.

• Under LinkedIn Page, click Verify.

• LinkedIn will generate a verification URL.

• Send this link to your page admin for approval.

• Once approved, your app is officially linked to your page.

---

Step 3: Enable Products

In the Products tab, click Request Access for:

• ✅ Community Management API

(Optional: you may also request “Marketing Developer Platform” if you plan to use analytics features.)

---

Step 4: Configure Redirect URL

Go to Auth → OAuth 2.0 Settings and add:

Then click Save changes.

---

Step 5: Add App Credentials to Stackposts

In Stackposts Admin → API Integrations → LinkedIn:

• Paste your Client ID and Client Secret under LinkedIn Page.

• Enable it and click Save changes.

---

Step 6: Required Scopes (Page)

Use the following OAuth 2.0 scope:

Explanation

• rw_organization_admin → Allows Stackposts to read, write, and manage LinkedIn Company Pages that the user administrates.

  • Fetch managed pages

  • Publish and schedule posts

  • Manage basic page data

---

🔹 Step 7: Connect LinkedIn in Stackposts

1. Go to Channels in Stackposts.

2. Click + Add Channels → select LinkedIn.

3. Choose + Profile or + Page depending on your target.

4. Log in to LinkedIn and approve the permissions.

5. Once authorized, your LinkedIn Profile or Page will appear under Channels.

---

🔹 Step 8: Start Publishing

• Go to Publishing → Compose or Bulk Posts.

• Choose your LinkedIn Profile or Page as the posting channel.

• Create, schedule, and publish posts directly from Stackposts.

---

⚙️ Troubleshooting

---

✅ You’re all set!
You now have:

• One LinkedIn App for Profiles

• One LinkedIn App for Pages

Both connected to Stackposts, ready for seamless publishing and page management.