LinkedIn Pages
This connector captures data from one LinkedIn Page into Flow collections via the LinkedIn Marketing API.
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.
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
- Go to the LinkedIn Developers' OAuth Token Tools and click Create token
- Your app will need the
r_organization_social
andrw_organization_admin
scopes: - Click "Request access token" and save the token.
Oauth Authentication
Create a LinkedIn OAuth App
- Create a LinkedIn Page if you don't have one.
- Create a developer application in LinkedIn's Developer Portal.
- Ensure your application complies with the Restricted Uses of LinkedIn Marketing APIs and Data.
- Apply to the Community Management API under the Products tab of your LinkedIn app and complete the form.
- Save your
client_id
andclient_secret
from the Auth tab.
Create a Refresh Token
- Go to the LinkedIn Developers' OAuth Token Tools and click Create token
- Your app will need the
r_organization_social
andrw_organization_admin
scopes: - 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 |