LinkedIn Pages
Sync overview
The LinkedIn Pages source currently supports Full Refresh only. Incremental Sync is coming soon.
Airbyte uses LinkedIn Marketing Developer Platform - API to fetch data from LinkedIn Pages.
Output schema
You can sync the following data as streams:
- Organization Lookup
- Follower Statistics
- Share Statistics
- Total Follower Count
- Follower Statistics Time Bound (Incremental)
- Share Statistics Time Bound (Incremental)
Data type mapping
| Integration Type | Airbyte Type | Notes |
|---|---|---|
number | number | float number |
integer | integer | whole number |
array | array | |
boolean | boolean | True/False |
string | string |
Features
| Feature | Supported?(Yes/No) | Notes |
|---|---|---|
| Full Refresh Overwrite Sync | Yes | |
| Full Refresh Append Sync | No | |
| Incremental - Append Sync | Yes | |
| Incremental - Append + Deduplication Sync | No | |
| Namespaces | No |
Performance
Official rate limits apply to LinkedIn Pages API usage, more information here. Rate-limited requests receive a 429 response.
The limits define the maximum API calls allowed within 24 hours. They reset daily at midnight UTC.
In rare cases, LinkedIn may return a 429 response to protect its infrastructure. API service returns to normal automatically. In these cases, you’ll receive this error message:
"Caught retryable error '<some_error> or null' after <some_number> tries. Waiting <some_number> seconds then retrying..."
This response is expected when the connector receives a 429 - Rate Limit Exceeded HTTP Error. You’ll receive this message after reaching the available API request capacity:
"Max try rate limit exceeded..."
The connector stops the sync after five unsuccessful attempts. Check your Rate Limits at on this page > Choose your app > Analytics.
Getting started
Assign the API user account the required permissions for each API endpoint.
Endpoints including Organization Lookup API, Follower Statistics, Share Statistics, Total Follower Count, Follower Statistics Time Bound and Share Statistics Time Bound require these permissions:
r_organization_social: Retrieve your company’s posts, comments, reactions and other engagement data.rw_organization_admin: Manage your company’s pages and retrieve reporting data.
Assign the API user account the ADMIN role.
Authentication
You can authenticate using Access Token or OAuth2.0.
OAuth2.0 is recommended because it streams data for 12 months. An access token streams data for two months.
Create the Refresh_Token or Access_Token
For OAuth2.0 authentication, the LinkedIn Pages source can use client_id, client_secret and refresh_token.
Alternatively, enter an access_token in the connector settings to make API requests. Access tokens expire after 2 months from creation date (60 days) and require you to authenticate again manually.
Refresh tokens expire after 12 months from creation date (365 days). If you receive a 401 invalid token response, the error logs will confirm that your token has expired. Re-authenticate your connection to generate a new token. You can find more details at here.
-
Log in to LinkedIn as the API user
-
Create an App here:
App Name: airbyte-sourceCompany: Search for and select your LinkedIn Company PagePrivacy policy URL: Link to the company privacy policyBusiness email: Developer or admin email addressApp logo: Airbyte’s (or Company’s) logo- Review and accept the legal terms, then create the app
- Review the Auth tab:
- Save your
client_idandclient_secret(for later steps) - Oauth 2.0 settings: Add a
redirect_uri(for later steps):https://airbyte.com
- Save your
-
Verify App:
- Open the Settings tab in your app dashboard. Select the Verify button.
- Generate the verification URL and give it to your Company’s LinkedIn Admin to verify the app.
-
Request API Access:
- Open the Products tab
- Select the Advertising API and accept the legal terms
- Wait a few minutes, then refresh the page. A
View access formlink replaces the Select button - Complete the access form. Access should be granted within 72 hours, but it’s usually quicker
-
Create A Refresh Token (or Access Token):
- Open the LinkedIn Developers’ OAuth Token Tools and select Create token
- Select your new app and tick the boxes for these scopes:
r_organization_socialrw_organization_admin
- Select Request access token. Once generated, save your Refresh token
-
Use Use the
client_id,client_secretandrefresh_tokenfrom steps 2 and 5 to authorise the LinkedIn Pages connector in the Airbyte UI.- Alternatively, use the Access token authentication method for 60-day access.
IP allow list
If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.
Troubleshooting
- Invalid or expired access token (401): Re-authenticate the source to get a valid LinkedIn access token.
- Organization access denied (403): Re-authenticate with the scope named in the error. If LinkedIn names no scope, authorise
r_organization_socialandrw_organization_admin. Ensure the authorised member has theADMINISTRATORrole for the configured company. - Organization not found or inaccessible (404): Check the Organization ID, page status, member’s admin role and app’s API access. The connection check requests one company by ID. It doesn’t list the member’s companies.
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 1.2.3 | 2026-11-10 | 91631 | Update dependencies |
| 1.2.2 | 2026-11-03 | 78804 | Update dependencies |
| 1.2.1 | 2026-10-30 | 90259 | Explain missing LinkedIn scopes and organization access failures in connection checks without echoing raw API errors |
| 1.2.0 | 2026-10-26 | 89710 | Retry rate limits and server errors with backoff, report expired tokens, missing permissions and retired API versions clearly, request only whole days for DAY and complete months for MONTH time-bound statistics (each month now arrives 2 days after it ends), add a concurrency option, and migrate legacy configs |
| 1.1.27 | 2026-10-20 | 89366 | Update LinkedIn API version to 202610 |
| 1.1.26 | 2026-09-14 | 85905 | Update LinkedIn Marketing API version from 202503 to 202608 |
| 1.1.25 | 2025-05-24 | 60685 | Update dependencies |
| 1.1.24 | 2025-05-10 | 59786 | Update dependencies |
| 1.1.23 | 2025-05-03 | 58801 | Update dependencies |
| 1.1.22 | 2025-04-19 | 58174 | Update dependencies |
| 1.1.21 | 2025-04-12 | 57721 | Update dependencies |
| 1.1.20 | 2025-04-05 | 56679 | Update dependencies |
| 1.1.19 | 2025-03-22 | 56029 | Update dependencies |
| 1.1.18 | 2025-03-18 | 55816 | Bump LinkedIn API to 202503 |
| 1.1.17 | 2025-03-08 | 55441 | Update dependencies |
| 1.1.16 | 2025-03-01 | 54775 | Update dependencies |
| 1.1.15 | 2025-02-22 | 54339 | Update dependencies |
| 1.1.14 | 2025-02-15 | 53859 | Update dependencies |
| 1.1.13 | 2025-02-08 | 53256 | Update dependencies |
| 1.1.12 | 2025-02-01 | 52767 | Update dependencies |
| 1.1.11 | 2025-01-25 | 52246 | Update dependencies |
| 1.1.10 | 2025-01-18 | 51798 | Update dependencies |
| 1.1.9 | 2025-01-11 | 51149 | Update dependencies |
| 1.1.8 | 2024-12-28 | 50645 | Update dependencies |
| 1.1.7 | 2024-12-21 | 50114 | Update dependencies |
| 1.1.6 | 2024-12-14 | 49593 | Update dependencies |
| 1.1.5 | 2024-12-12 | 49272 | Update dependencies |
| 1.1.4 | 2024-12-11 | 48924 | Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64 |
| 1.1.3 | 2024-10-29 | 47749 | Update dependencies |
| 1.1.2 | 2024-10-28 | 47455 | Update dependencies |
| 1.1.1 | 2024-08-16 | 44196 | Bump source-declarative-manifest version |
| 1.1.0 | 2024-08-15 | 44132 | Refactor connector to manifest-only format |
| 1.0.17 | 2024-08-10 | 43560 | Update dependencies |
| 1.0.16 | 2024-08-03 | 43281 | Update dependencies |
| 1.0.15 | 2024-07-27 | 42782 | Update dependencies |
| 1.0.14 | 2024-07-20 | 42218 | Update dependencies |
| 1.0.13 | 2024-07-13 | 41833 | Update dependencies |
| 1.0.12 | 2024-07-10 | 41407 | Update dependencies |
| 1.0.11 | 2024-07-09 | 41274 | Update dependencies |
| 1.0.10 | 2024-07-06 | 40828 | Update dependencies |
| 1.0.9 | 2024-06-25 | 40422 | Update dependencies |
| 1.0.8 | 2024-06-22 | 39975 | Update dependencies |
| 1.0.7 | 2024-06-13 | 36744 | Add time bound incremental streams for follower & share statistics. Migrate to Low Code |
| 1.0.6 | 2024-06-06 | 39171 | [autopull] Upgrade base image to v1.2.2 |
| 1.0.5 | 2024-06-03 | 38918 | Replace AirbyteLogger with logging.Logger |
| 1.0.4 | 2024-06-03 | 38918 | Replace AirbyteLogger with logging.Logger |
| 1.0.3 | 2024-05-21 | 38526 | [autopull] base image + poetry + up_to_date |
| 1.0.2 | 2023-05-30 | 24352 | Remove duplicate streams |
| 1.0.1 | 2023-03-22 | 24352 | Remove authSpecification as it’s not yet supported |
| 1.0.0 | 2023-03-16 | 18967 | Fixed failing connection checks |
| 0.1.0 | 2022-08-11 | 13098 | Initial Release |