Increasing Access
Warning
Deprecation Notice
The Marketing Version 202308 (Marketing August 2023) and earlier versions (excluding 202306 and 202307) have been sunset. Additionally, the unversioned APIs will be sunset soon. We recommend that you migrate to the versioned APIs as well as migrate to the new Content and Community Management APIs to avoid disruptions. See the Migration page for more details.
If you haven’t yet migrated and have questions, submit a request on the LinkedIn Developer Support Portal.
This page provides details on the available permissions, guidance on upgrading your access level, and instructions for requesting access to APIs and permissions.
What permissions are available?
API Product | Availability | How to Request | Permission |
---|---|---|---|
Advertising API | Available to all developers approved for Advertising API access. | Apply to Advertising API | r_1st_connections_size r_ads_reporting r_basicprofile r_organization_admin r_organization_social r_ads rw_ads rw_organization_admin w_member_social w_organization_social |
Matched Audiences | Available to qualified developers who meet additional criteria for access. | Submit a request through Developer Support. | rw_dmp_segments |
Audience Insights | Available to qualified developers who meet additional criteria for access. | Submit a request through Developer Support. | Developer application is assigned the Audience Insight permission and doesn't need to be additionally requested during token generation. |
Media Planning | Available to qualified developers who meet additional criteria for access. | Submit a request through Developer Support. | Developer application is assigned the Media Planning permission and doesn't need to be additionally requested during token generation. |
Lead Sync API | Available to all developers approved for Lead Sync API access. | Apply to Lead Sync API. | r_marketing_leadgen_automation |
Conversions API | Available to all developers approved for Conversions API access. | Apply to Conversions API. | rw_conversions |
Community Management API | Available to all developers approved for Community Management API access. | Apply to Community Management API. | r_1st_connections_size r_basicprofile r_organization_followers r_organization_social r_organization_social_feed rw_organization_admin w_member_social w_member_social_feed w_organization_social w_organization_social_feed |
In addition to these permissions, members must have the appropriate roles as defined in Company Page Roles and Ad Account Roles to act on or read data from a given Company Page or Ad Account. See How Do I Know What Roles a Member Has to determine which roles an authenticated member has through the API.
Note
- Access to Advertising API is a mandatory requirement for utilizing Matched Audience and Audience Insights.
- Audience Insights API does not require any additional member permission to be passed in OAuth2 scope for member consent.
Important
See the full list below in the section API Products and Permissions table.
How to Upgrade your Access Tier
The Advertising API and Community Management API each have two access tiers with different access criteria. All applications start with Development tier. You will have to apply separately for Standard tier.
- For Advertising API, Development tier is designed to build end-to-end workflows and supports read-only access for unlimited ad accounts and edit capabilities for up to five (5) Ad Accounts. Standard tier is designed to support campaign management solutions for multiple ad accounts.
- For Community Management API, Development tier is designed to build and test integrations with API call restrictions; you are expected to complete your integration and testing within twelve months after you received API access. Standard tier is designed for live production with no restrictions.
API | Access Tier | Description | API Access Granted | Request Process |
---|---|---|---|---|
Advertising | Development | Build end-to-end workflows | Apply for access to Advertising API | |
Advertising | Standard | Support campaign management for multiple ad accounts | The Standard API Access must be requested via a support ticket to be submitted on the Developer Support Portal. | |
Community Management | Development | This is the default tier provisioned. Developers are expected to build core business use cases, using the provided permissions and APIs, within twelve (12) months of the provisioning. | All APIs:
|
Apply for access to Community Management API Development tier |
Community Management | Standard | This is the full-featured capability of the program | No restrictions | Apply for Standard tier |
Important
LinkedIn reserves the right to review applications and select partners at its discretion and a partner might not be upgraded even if they meet these minimum requirements.
API Products and Permissions
Following is a complete list of permissions available for the API products offered by LinkedIn. Once your API access is approved, the corresponding permissions will be granted.
Permission | Description | Type | APIs Products Accessible |
---|---|---|---|
r_1st_connections_size |
Returns the number of 1st-degree connections (GET /networkSizes memberToMember). | Member Permission (3-legged) | Advertising API Community Management API. |
r_ads |
Retrieve your advertising accounts. | Member Permission (3-legged) | Advertising API Lead Sync API Conversions API. |
r_ads_reporting |
Retrieve reporting for your advertising accounts. | Member Permission (3-legged) | Advertising API |
r_basicprofile |
Provides access to a minimum set of member profile fields keyed by a Person URN. | Member Permission (3-legged) | Advertising API Community Management API. |
r_organization_followers |
Return your organization's followers. | Member Permission (3-legged) | Community Management API |
r_organization_admin |
Retrieve your organization’s pages and their reporting data (including follower, visitor and content analytics). | Member Permission (3-legged) | Advertising API Lead Sync API. |
r_organization_social |
Retrieve your organizations' posts, including any comments, likes and other engagement data with AUTHOR injection. | Member Permission (3-legged) | Advertising API Community Management API. |
r_organization_social_feed |
Read social actions for organizations that you are an administrator of to focus on Community Management partners. | Member Permission (3-legged) | Community Management API |
rw_ads |
Manage and read an authenticated member's ad accounts. Restricted to ad accounts in which the authenticated member has one of the following ad account roles. ACCOUNT_BILLING_ADMIN ACCOUNT_MANAGER CAMPAIGN_MANAGER CREATIVE_MANAGER . |
Member Permission (3-legged) | Advertising API |
rw_organization_admin |
Manage your organizations' pages and retrieve reporting data. | Member Permission (3-legged) | Advertising API Community Management API. |
w_member_social |
Post, comment and like posts on your behalf. | Member Permission (3-legged) | Advertising API Community Management API. |
w_member_social_feed |
Create, modify, and delete comments and reactions on posts on your behalf. | Member Permission (3-legged) | Community Management API |
w_organization_social |
Post, comment and like posts on your organization's behalf. | Member Permission (3-legged) | Advertising API Community Management API. |
r_ads_leadgen_automation |
Retrieve your organization's events. | Member Permission (3-legged) | Lead Sync API |
r_events |
Access your Lead Gen Forms and retrieve leads. | Member Permission (3-legged) | Lead Sync API |
r_liteprofile |
r_liteprofile_description : "Use your name, headline, and photo.". | Member Permission (3-legged) | Lead Sync API Conversions API |
r_marketing_leadgen_automation |
Provides API access to sync leads for different marketing use cases | Member Permission (3-legged) | Lead Sync API |
r_organization_admin |
Retrieve your organization’s pages and their reporting data (including follower, visitor and content analytics). | Member Permission (3-legged) | Advertising API Lead Sync API |
rw_dmp_segments |
Create and manage your matched audiences. | Member Permission (3-legged) | Matched Audiences |
rw_conversions |
Upload your conversion data to LinkedIn and manage your conversion tracking data. | Member Permission (3-legged) | Conversions |
rw_offlineConversions |
Upload your offline conversions data to LinkedIn and manage your conversions and conversion tracking data. | Member Permission (3-legged) | Offline Conversions |