Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 Advertising API 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 | |
| ADS-001 | Demonstrate OAuth 2.0 integration, with right scopes, consent screen. |
| ADS-002 | Demonstrate ability to periodically verify that an access token is valid (heartbeat /me). |
| ADS-003 | Demonstrate ability to detect access token expiry. |
| ADS-004 | Demonstrate ability to re-trigger OAuth Flow in case token has expired or been invalidated. |
| ADS-005 | Demonstrate ability to use refresh tokens to mint new access tokens. |
| ADS-006 | Demonstrate ability to detect refresh token expiry and re-trigger OAuth Flow. |
| Account Structure (Hierarchy) and Basic control | |
| ADS-101 | Demonstrate ability to retrieve all Sponsored Accounts with status for the logged in user. |
| ADS-102 | Demonstrate ability to retrieve all CampaignsGroups with status within Sponsored Accounts. |
| ADS-103 | Demonstrate ability to retrieve all Campaigns with status within Sponsored Accounts. |
| ADS-104 | Demonstrate ability to retrieve all Creatives with status within Campaigns. |
| ADS-105 | Demonstrate ability to visualize account hierarchy (accounts -> Creative (Ad)). |
| ADS-106 | Demonstrate ability to PAUSE and ACTIVATE existing Campaigns and Creatives. |
| ADS-107 | Demonstrate ability to update Bid amounts for Campaigns. |
| Creating a Sponsored campaign (text ad/image ads/article ads/video ads) | |
| ADS-201 | Showcase Objective Based Advertising (OBA) experience in the campaign creation UX. |
| ADS-202 | Demonstrate ability to create 2 or more types of sponsored campaigns. |
| ADS-203 | Demonstrate ability to edit and archive all loaded sponsored campaigns. |
| ADS-204 | Demonstrate ability to use an existing image share or article share to create a creative in the campaign. |
| ADS-205 | Demonstrate ability to create a dark share (image/article) to create a creative in the campaign. |
| ADS-206 | Demonstrate ability to schedule a campaign Start/End Date. |
| Targeting proficiency | |
| ADS-301 | Demonstrate ability to offer all targeting facets in parity with Campaign Manager UI. |
| ADS-302 | Demonstrate ability to visualize targeting expressiveness (boolean structure, with include/exclude). |
| Reporting | |
| ADS-501 | Demonstrate ability to perform Campaign Reporting based on Campaign hierarchy. |
| ADS-502 | Demonstrate ability to perform Campaign Reporting based on Demographic pivots. |