Skip to content

Latest commit

 

History

History
73 lines (49 loc) · 5.7 KB

linkedin-pages.md

File metadata and controls

73 lines (49 loc) · 5.7 KB

LinkedIn Pages

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

ghcr.io/estuary/source-linkedin-pages:dev provides the latest connector image. You can also follow the link in your browser to see past image versions.

Supported Streams

By default, each resource is mapped to a Flow collection through a separate binding.

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

Property Title Description Type Required/Default
/organization_id Organization ID Your unique organization's id, found in the url of your bussiness' Organization Page string Required
/client_id Client ID Your Oauth app's client id. string Required
/client_secret Client Secret Your Oauth app's client secret. string Required
/refresh_token Refresh Token The token value generated using the LinkedIn Developers OAuth Token Tools. string Required
/access_token Access Token The token value generated using the LinkedIn Developers OAuth Token Tools. string Required