Skip to main content
1

Create a new app

Head over to LinkedIn developers and create a new app.
2

Verify your app

Verify your app with LinkedInYou will need to follow the verification process to request the necessary permissions listed below.
3

Add required products

Fill in all the details, once created head over to Products and make sure you add all the required products:
  • Share on LinkedIn
  • Advertising API
  • Sign in with LinkedIn using OpenID connect
It is important to request the Advertising API permissions and fill up the request form, or you will not have the ability to refresh your tokens.
4

Check the granted scopes

Under the Auth tab of your app, the “OAuth 2.0 scopes” section must list all of the scopes Postiz requests:
  • openid
  • profile
  • w_member_social
  • r_basicprofile
  • rw_organization_admin
  • w_organization_social
  • r_organization_social
The last four come from the Advertising API product, w_member_social from Share on LinkedIn, and openid / profile from Sign In with LinkedIn using OpenID Connect.
If a scope is missing, LinkedIn does not fail the login. It issues a token without that scope, and Postiz rejects the connection with a NotEnoughScopes error. If you get that error, this Auth tab list is the first place to check.
5

Configure OAuth2 Redirect URI

Your LinkedIn Page OAuth2 Redirect URI:
  • Production: https://your-postiz-domain.com/integrations/social/linkedin-page
  • Local development: http://localhost:4200/integrations/social/linkedin-page
  • Docker: http://localhost:5000/integrations/social/linkedin-page
6

Copy your credentials

Copy the created Client ID and Client Secret and add them to your .env file.
You can find those under the Auth Tab of your LinkedIn App in the developer portal.

​
Posting PDFs / document carousels

LinkedIn is the only provider Postiz supports PDF posting on, and only through document-carousel posts. When you create a carousel of images on a LinkedIn Page, Postiz combines the images into a PDF document and uploads it as a LinkedIn document share. You don’t upload a PDF directly. Postiz produces the PDF from your images. This is not supported on other platforms; the public-API upload endpoint does not accept application/pdf.