To get started, apply to the Marketing Developer Program. Once you’ve been approved, understand what you have access to. Some APIs and permissions require additional approval. The information below will guide you through how to upgrade your access tier or how to request access to private APIs and permissions.
How to apply to the Marketing Developer Platform
- Create a developer App in the Developer Portal.
- Apply to the Marketing Developer Platform (“MDP”) under the Products tab of your app.
- Complete the MDP access form under My Apps > Products.
- You will receive a confirmation email when your application has been reviewed.
Your application may take a few days to review.
Some activities are not allowed on LinkedIn, so make sure to review the restricted use cases before you submit your application.
What permissions are available?
The Marketing Developer Platform(MDP) gives access to the following permissions. All these permission scopes are 3-legged permissions requiring explicit approval by a LinkedIn member. The 2-legged client credentials flow is not available for any marketing use cases.
|Product or Program||Permission||Description|
|Marketing Developer Platform (MDP)||rw_organization_admin||Member Auth: Manage an authenticated member’s company pages and retrieve reporting data.|
|Marketing Developer Platform (MDP)||w_organization_social||Member Auth: Post, comment and like posts on behalf of an organization. Restricted to organizations in which the authenticated member has one of the following company page roles.|
|Marketing Developer Platform (MDP)||r_organization_social||Member Auth: Retrieve organizations' posts, comments, and likes.|
|Marketing Developer Platform (MDP)||w_member_social||Member Auth: Post, comment and like posts on behalf of an authenticated member.|
|Marketing Developer Platform (MDP)||rw_ads||Member Auth: 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:
|Marketing Developer Platform (MDP)||r_ads||Read an authenticated member's ad accounts. Restricted to ad accounts in which the authenticated member has one of the following ad account roles:
|Marketing Developer Platform (MDP)||r_ads_reporting||Member Auth: Retrieve reporting for advertising accounts.|
|Marketing Developer Platform (MDP)||r_1st_connections_size||Member Auth: Retrieve the count of an authenticated member's 1st-degree connections.|
|Marketing Developer Platform (MDP)||r_basicprofile||Member Auth: Read an authenticated member's basic profile including name, photo, headline, and public profile URL.|
|Lead Generation||r_ads_leadgen_automation||Member Auth: Access an authenticated member's Lead Gen Forms and retrieve leads.|
|Audiences||rw_dmp_segments||Member Auth: Create and manage matched audiences.|
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.
rw_dmp_segments may be applied for after being an approved Marketing Developer Platform partner. See API and Permission Tiers section below to learn more.
How to Upgrade your Access Tier
LinkedIn has two access tiers, which define how many ad accounts you can manage: Development and Standard. All applications start with Development tier. Standard tier access is meant for solutions that support campaign management for multiple accounts.
To upgrade to Standard tier, first build and test your application and then submit a a tier upgrade request including a video demonstrating how your platform creates, edits, and/or optimizes LinkedIn campaigns.
|Access tier||Description||API access granted||How to request|
|Development||Build end-to-end workflows||Apply to the Marketing Developer Platform|
|Standard||Support campaign management for multiple accounts||Build and Test
In the Developer Portal, select your app>Product>View Ad Accounts. Select "send us an email" link to submit a tier upgrade request. Specify “Standard API Access” in the subject line and provide a video demonstrating how your platform creates, edits and/or optimizes LinkedIn ad campaigns.
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 and Permission Tiers
|Tier||Availability||Products||Permissions||How to Request|
|Vetted||Available to all developers approved for the Marketing Developer Platform (“MDP”)||Campaign Management||rw_ads
|Apply to the Marketing Developer Platform|
|Reporting and ROI||r_ads_reporting||(Apply)|
|Private||Available to qualified MDP developers who meet additional criteria for access||Lead Generation||r_ads_leadgen_automation
|Submit a request through Developer Support|