LinkedIn Page
How to configure a LinkedIn company page for OpenQuok — TikTok Developer portal, OAuth redirect URI, scopes, and backend env vars
Connect your agent today
Draft from chat, review in your calendar, and publish only what you approve.
Overview
Connect a LinkedIn company Page with identifier linkedin-page. OAuth is two-step: sign in with LinkedIn, then pick the Page you administer. Publishing uses the official LinkedIn REST Posts API.
For personal profiles, see LinkedIn. Both channels share the same LinkedIn developer app credentials.
One LinkedIn app
Features
Supported
| Feature | Details |
|---|---|
| Text posts | Up to 3,000 characters |
| Images | Multi-image posts |
| MP4 video | One attachment per post |
| Follow-up text comments | Text-only replies after the main post |
| Image → PDF document carousel | ≥2 images, no video; enable Post as image carousel in composer settings — OpenQuok combines images into a PDF document share at publish time. Optional Carousel document title (default: slides). LinkedIn is the only OpenQuok provider with document-carousel posts |
| Account analytics | Page-level insights |
| Per-post analytics | Engagement metrics on published posts |
| Cross-account comment / reshare plugs | In per-channel settings, enable Add comments by a different account or Add re-posters; pick other connected LinkedIn channels, set a delay, and (for comments) the message text. Rules run after the post is live |
| Page auto-repost / auto-plug | On a connected linkedin-page channel, open Plugs: Auto repost posts (reshare when likes reach a threshold, up to 3 times every 6 hours) and Auto plug post (promotional comment from the Page) |
| Company mention | Composer toolbar LinkedIn icon — paste a linkedin.com/company/… URL to insert an organization mention tag |
| @-mention lookup | Same as personal LinkedIn — unlock the Page channel in custom mode, type @ plus at least two characters (or use the toolbar @ button), then pick an organization from suggestions |
Not supported
| Feature | Notes |
|---|---|
| Direct PDF file upload | Attach ≥2 images (no video); OpenQuok builds the PDF at publish time — the public media upload API does not accept application/pdf |
Other providers
application/pdf for other social channels.Backend environment
Set in backend/.env.development.local (see backend/.env.development.example):
- LINKEDIN_CLIENT_ID
- LINKEDIN_CLIENT_SECRET
Restart the backend after changing env vars.
OAuth redirect URI
Register this redirect URI in your LinkedIn app (Auth tab). The path is built from FRONTEND_DOMAIN_URL:
https://YOUR-FRONTEND-DOMAIN/integration/oauth/linkedin-pageLocal development example:
https://localhost:5173/integration/oauth/linkedin-pageLinkedIn developer app setup
Create an app
Create an app at LinkedIn Developers.
Verify your app
Company Page required
In order to verify your app, you must first create a LinkedIn company Page.
In Home Page → For Business → Create a Company Page:
Add required products
In Products, add all required products. They include:
- Share on LinkedIn
- Sign in with LinkedIn using OpenID Connect
- Advertising API
Note
OpenQuok requests openid and profile during OAuth and loads the signing-in member from LinkedIn’s /v2/userinfo endpoint before the Page picker.
Advertising API
Request the Advertising API product and complete LinkedIn’s access form. Without it, refresh tokens may not work and channels can disconnect.
In Auth, after verification is completed, you can verify that the following organization scopes are automatically added:
- rw_organization_admin
- w_organization_social
- r_organization_social
Set redirect URI
In Auth, add the Page OAuth redirect URI (see OAuth redirect URI above). If you also use linkedin, add that URI too (see LinkedIn — OAuth redirect URI).
Copy credentials
Copy Client ID and Client Secret into LINKEDIN_CLIENT_ID and LINKEDIN_CLIENT_SECRET.