Getting Access

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

  1. Create a developer App in the Developer Portal.
  2. Apply to the Marketing Developer Platform (“MDP”) under the Products tab of your app.
  3. Complete the MDP access form under My Apps > Products.
  4. You will receive a confirmation email when your application has been reviewed.

Caution

Your application may take a few days to review.

MDP

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:
  • ACCOUNT_BILLING_ADMIN
  • ACCOUNT_MANAGER
  • CAMPAIGN_MANAGER
  • CREATIVE_MANAGER
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:
  • ACCOUNT_BILLING_ADMIN
  • ACCOUNT_MANAGER
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.

The r_ads_leadgen_automation and 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
  • 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 to the Marketing Developer Platform
    Standard Support campaign management for multiple 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
  • 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.

    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 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
    r_ads
    Apply to the Marketing Developer Platform
    Reporting and ROI r_ads_reporting (Apply)
    Page Management rw_organization_admin
    w_organization_social
    r_organization_social
    w_member_social
    r_1st_connections_size
    r_basicprofile
    (Apply)
    Private Available to qualified MDP developers who meet additional criteria for access Lead Generation r_ads_leadgen_automation
    r_events_leadgen_automation
    Submit a request through Developer Support
    Audiences rw_dmp_segments (Request)