Share via

Increasing Access

  • Article

Warning

Deprecation Notice
The Marketing Version 202405 (Marketing May 2024) has been sunset. We recommend that you migrate to the latest 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 API Available to qualified developers who meet additional criteria for access. Submit a request through Developer Support. rw_dmp_segments
Audience Insights API Available to qualified developers who meet additional criteria for access. Submit a request through Developer Support. Developer application is assigned the Audience Insights permission and doesn't need to be additionally requested during member token generation.
Media Planning API 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 member token generation unless to save and retrieve created media plans.

rw_media_plans
Lead Sync API Available to all developers approved for Lead Sync API access. Apply to Lead Sync API. r_marketing_leadgen_automation
r_ads
r_events
r_liteprofile
r_organization_admin
Conversions API Available to all developers approved for Conversions API access. Apply to Conversions API. rw_conversions
r_ads
r_liteprofile
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
r_member_profileAnalytics(supported only in API versions starting from 202504)
Events Management API Available to all developers as a self-serve API product on request. Apply to Events Management API. r_events
rw_events

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 applying to Matched Audiences API, Audience Insights API and Media Planning API.
  • 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 Retrieve the number of 1st-degree connections within your network. 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 Use your basic profile including your name, photo, headline, and public profile URL. Member Permission (3-legged) Advertising API

    Community Management API
    r_organization_followers Use your followers' data so your organization can mention them in posts. 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
    w_organization_social_feed Manage social actions for organizations that you are an administrator of. Member Permission (3-legged) Community Management API
    r_events Retrieve your organization's events. Member Permission (3-legged) Lead Sync API

    Events Management API
    rw_events Manage your organization's events. Member Permission (3-legged) Events Management API
    r_liteprofile Use your name and photo. Member Permission (3-legged) Lead Sync API

    Conversions API
    r_marketing_leadgen_automation Access your lead generation forms and retrieve leads (including event leads, ad leads, and organization page leads). 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 API
    rw_conversions Upload your conversion data to LinkedIn and manage your conversion tracking data. Member Permission (3-legged) Conversions API
    rw_media_plans Manage media plans for your advertising accounts. Member Permission (3-legged) Media Planning API
    r_member_profileAnalytics Retrieve your profile analytics, including number of profile viewers, followers, and search appearances. Member Permission (3-legged) Community Management API
    (in API versions starting from 202504)