Increasing Access

  • Article

Warning

Deprecation Notice
The Marketing version 202304 (Marketing April 2023) and below has been sunset and the unversioned APIs are going to 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
  • Read: No limits on reading data related to Ad Accounts you administer
  • Create : Access to create 1 test Ad Account through the API. All real Ad Accounts must be created through the Campaign Manager tool in this tier.
  • Edit: Make updates related to up to 5 ad accounts that you administer.
    		•  Apply for access to Advertising API
    Advertising Standard Support campaign management for multiple ad accounts
  • Read : No limits on reading data for Ad Accounts you administer
  • Create : Create unlimited Ad Accounts
  • Edit : Make unlimited updates to Ad Accounts that you administer
    		•  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:
    • 100 API calls for an app for 24 hrs
    • 10 API calls per member per of an App for 24 hrs
    All APIs with BATCH_GET:
  • No API calls allowed Webhook for Social Actions
  • Push notifications disabled
    		•  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