Skip to main content

LinkedIn Pages

This connector captures data from one LinkedIn Page into Flow collections via the LinkedIn Marketing API.

This connector is based on an open-source connector from a third party, with modifications for performance in the Flow system. You can find their documentation here, but keep in mind that the two versions may be significantly different.

Prerequisites​

  • An existing LinkedIn Account

The API user account should be assigned the ADMIN role and the following permissions for the API endpoints. Endpoints such as: Organization Lookup API, Follower Statistics and Share Statistics require these permissions:

  • r_organization_social: Read the organization's posts, comments, reactions, etc.
  • rw_organization_admin: Write and read the organization's pages and read reporting data.

Authentication​

This connector's authentication can be configured by either passing a LinkedIn access token or using Oauth to connect to your source. Oauth requires the additional setup of verifying your application with LinkedIn in order to use the required scopes.

You can see more details about the Community Management App Review in LinkedIn's Docs.

info

LinkedIn access tokens expire in 60 days. You must manually update your capture configuration to continue to capture data from LinkedIn.

Refresh tokens expire after 365 days from their creation date. If you receive a 401 invalid token response error, it means that the access token has expired and you need to generate a new token. You can see more details about it in LinkedIn's Docs.

Access Token Authentication​

  1. Go to the LinkedIn Developers' OAuth Token Tools and click Create token
  2. Your app will need the r_organization_social and rw_organization_admin scopes:
  3. Click "Request access token" and save the token.

Oauth Authentication​

Create a LinkedIn OAuth App​

  1. Create a LinkedIn Page if you don't have one.
  2. Create a developer application in LinkedIn's Developer Portal.
  3. Ensure your application complies with the Restricted Uses of LinkedIn Marketing APIs and Data.
  4. Apply to the Community Management API under the Products tab of your LinkedIn app and complete the form.
  5. Save your client_id and client_secret from the Auth tab.

Create a Refresh Token​

  1. Go to the LinkedIn Developers' OAuth Token Tools and click Create token
  2. Your app will need the r_organization_social and rw_organization_admin scopes:
  3. Click "Request access token" and save the token.

Configuration​

You configure connectors either in the Flow web app, or by directly editing the catalog specification file. See connectors to learn more about using connectors. The values and specification sample below provide configuration details specific to the LinkedIn Pages source connector.

Properties​

PropertyTitleDescriptionTypeRequired/Default
/organization_idOrganization IDYour unique organization's id, found in the url of your bussiness' Organization PagestringRequired
/client_idClient IDYour Oauth app's client id.stringRequired
/client_secretClient SecretYour Oauth app's client secret.stringRequired
/refresh_tokenRefresh TokenThe token value generated using the LinkedIn Developers OAuth Token Tools.stringRequired
/access_tokenAccess TokenThe token value generated using the LinkedIn Developers OAuth Token Tools.stringRequired

Supported Streams​