Integration Requirements for Media Planning

Warning

Deprecation Notice: The Marketing Version 202508 (Marketing August 2025) will be sunset on August 17, 2026. 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.

LinkedIn is in the process of rolling out a Technical Sign Off process for the Media Planning program. This ensures that our members get the best experience whether using LinkedIn's native UI or a partner product. The technical review and sign off also ensures that there are no gaps in integrations and that partner products keep up with the latest features and updates released by LinkedIn.

As an API partner, please go through the requirements listed below. These are the capabilities that an integrating partner is expected to build in their product. We request you to plan and incorporate these features early in your design. When you're nearing completion, you must initiate a Technical Sign Off request by contacting your LinkedIn POC on the Business Development team.

A demo will be scheduled during which you'll be asked to showcase all your product capabilities. During this evaluation, LinkedIn can suggest modifications which should be completed for the sign off. If all criteria are met (as per the envisioned scope), the technical sign-off is awarded.

Requirements

Rule	API capabilities to be demonstrated in Demo
	Basics
MP-001	Demonstrate OAuth 2.0 integration with minimum permission scopes and consent screen.
MP-002	Demonstrate ability to periodically verify that an access token is valid (heartbeat /me) and detect access token expiry.
MP-003	Demonstrate ability to detect access token expiry and ability to use refresh tokens to renew access tokens to extend beyond their expiry.
MP-004	Demonstrate ability to detect refresh token expiry and re-trigger OAuth Flow.
MP-005	Demonstrate ability to have consistent oauth2 scope permissions to avoid token conflicts.
	Media Planning
MP-101	Demonstrate ability to retrieve all Sponsored Ad Accounts (id, name, status) for the logged in user.
MP-102	Demonstrate the ability to allow users to select one of the fetched ad accounts and the selected ad account should be then passed to subsequent API requests metadata.
MP-103	Demonstrate ability to input combination of at least three targeting facets. for example: age, gender, industries, job functions, titles, skills, interests etc.
MP-104	Demonstrate ability to input target budget, start and end dates for forecasting.
MP-105	Demonstrate ability to select an Objective Type(mandatory) and an Optimization Type(optional) value as input.
MP-106	Demonstrate ability to enable and disable LinkedIn Audience Network and LinkedIn Audience Expansion as inputs to forecast for campaigns.
MP-107	Demonstrate ability that you require to input one or more geo location urn and throw validation error if no geo location selected.
MP-108	Demonstrate ability to return points from at least one metric curve(reach/impressions/lead/reach percentage) in Media Planning API response.
MP-109	Demonstrate error handling and user input validation, especially when audience is under 300, input budget in less than $100 or start/end date range is invalid. Note: The start date and end date are optional inputs and defaults to today's date in UTC and 90 days after respectively. If set explicitly, both the dates must be in the future and the duration between them should not exceed 90 days.
	Saved Audience Templates
MP-201	Demonstrate ability to save the ad targeting criteria (used to generate Media Plan) in a new template in the selected ad account and allow user to input its name and description.
MP-202	Demonstrate ability to read all available previously saved ad targeting templates in the selected ad account with name, desc and targeting criteria.
MP-203	Demonstrate ability to update the ad targeting criteria (used to generate Media Plan) in an existing template saved in the selected ad account with name, desc, targetingCriteria.
MP-204	Demonstrate that saved templates are ready for activation in campaigns.