Increasing Access

Warning

Deprecation Notice: The Marketing Version 202505 (Marketing May 2025) has been sunset. We recommend that you migrate to the latest versioned APIs to avoid disruptions. For information on all the supported versions, refer to the migrations documentation. 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.

Tip

Not sure where to start? The Advertising API, Community Management API, Events Management API, Lead Sync API, and Conversions API are open to all approved developers — apply through the standard process. Access to Matched Audiences, Audience Insights, Media Planning, and Company Intelligence APIs is restricted to developers who meet additional qualification criteria evaluated by LinkedIn.

What permissions are available?

The following table lists each LinkedIn Marketing API product, who can access it, how to request access, and the OAuth permissions granted upon approval. General Availability (GA) programs are open to all approved developers; restricted programs require meeting additional criteria evaluated by LinkedIn.

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. Access to Advertising API first, before submitting the form as it is an obligatory pre-requisite. Submit a request through the form here. LinkedIn will contact you up to 60 days after the form submission only if we will identify meeting access criteria and a strong partnership fit. rw_dmp_segments
Audience Insights API Available to qualified developers who meet additional criteria for access. Submit the application survey. Developer application is assigned the Audience Insights permission. Additional member permission is not required.
Media Planning API Available to qualified developers who meet additional criteria for access. Submit the application survey. Developer application is assigned the Media Planning permission. Additional member permission is not required unless you need 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 for 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)
  • r_member_postAnalytics(supported only in API versions starting from 202506)
Events Management API Available to all developers as a self-serve API product on request. Apply to Events Management API.
  • r_events
  • rw_events
Company Intelligence API Available to qualified developers who meet additional criteria for access. Submit a request through Developer Support. Developer application is assigned the Company Intelligence API permission. The authenticated member must have consented to the r_ads_reporting permission of the Advertising API product for your developer app. If the member has already consented through an existing integration (e.g., Ad Analytics API), you can use their existing member access token and do not need to require re-authentication.

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.
  • For restricted APIs, LinkedIn evaluates applications based on partnership fit and access criteria. Matched Audiences API responses take up to 60 days. Other restricted APIs are evaluated on a case-by-case basis with no fixed timeline — contact Developer Support for status updates.
  • Refer to the list in the 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 must apply separately to upgrade to the Standard tier.

  • 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 including edit capabilities for unlimited ad accounts.
  • Community Management API: Development tier is designed to build and test integrations with API call restrictions. You must complete your integration and testing within twelve months of receiving the 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:
  • 500 API calls for an app for 24 hrs
  • 100 API calls per member 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

The following table lists all OAuth permission scopes available across LinkedIn Marketing API products. All permissions listed are Member Permissions (3-legged OAuth), meaning they require an authenticated LinkedIn member to grant consent — your application requests these scopes during the OAuth authorization flow. For details on implementing OAuth, see Authorization Code Flow. Once your API access is approved, the corresponding permissions are automatically granted to your application.

Permission Description Type API 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 follower data to enable your organization to mention them in posts. Member Permission (3-legged). Community Management API.
r_organization_admin Retrieve your organization pages and reporting data, including follower, visitor, and content analytics. Member Permission (3-legged). Advertising API, Lead Sync API.
r_organization_social Retrieve your organization 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 where the authenticated member has one of the following roles: ACCOUNT_BILLING_ADMIN, ACCOUNT_MANAGER, CAMPAIGN_MANAGER, CREATIVE_MANAGER. Member Permission (3-legged). Advertising API.
rw_organization_admin Manage organizations pages and retrieve reporting data. Restricted to organizations in which the authenticated member has the following role: ADMINISTRATOR. Member Permission (3-legged). Community Management API, Advertising 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.
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_postAnalytics Retrieve analytics for your posts, including impressions, reactions, comments, and shares. Member Permission (3-legged). Community Management API (in API versions starting from 202506).
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).

Next Steps

Once you have identified the API product and access tier you need, use the resources below to continue:

  • Last updated on