LinkedIn

LinkedIn Use Cases > Sponsored API

In order to support collecting leads for sponsored use cases, a partner app needs to build a UX where a user is able to select the sponsored accounts and forms to collect leads for. ###### Step 1: Obtain user authorization to access their leads ###### Step 2: Get the user's sponsored accounts ###### Step 3: Ask the user to select the sponsored account(s) whose leads they are interested in syncing ###### Step 4: Validate the user's organization role tied to the chosen sponsored account ###### Step 5: Retrieve forms for the user's selected sponsored account ###### Step 6: Ask the user to select and map fields to the target destination (e.g. a CRM) ###### Step 7: Allow the user to do a one time pull of all form responses looking back up to 365 days to grab any missed leads ###### Step 8: \[PULL\] Schedule periodic form response pulls to collect leads ###### Step 8: \[PUSH\] Allow the user to subscribe for lead notification webhooks ###### Step 9: \[PUSH\] Fetch full lead data after a webhook notification is received

Documentation GitHub OpenAPI

Business capability

Demand Generation Management BC-400.40

Operations 7

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /organizationAcls Check a user's roles on organization pages · LinkedIn 4. Validate the User's Organization Role #

Ask an LLM

“Which company pages does the signed-in member hold an admin role on?”

“Can I confirm a user is allowed to pull leads for a company page before syncing?”

Tell an agent

Check which organization roles the current user holds, limited to state {state}.

Validate the signed-in user's company page roles before starting lead sync.

GET /leadForms List lead gen forms for a sponsored account · LinkedIn 5. Get Forms for the Chosen Sponsored Account #

Ask an LLM

“Which lead gen forms exist on the ad account I picked for lead sync?”

“Can I page through lead forms owned by one sponsored account?”

Tell an agent

List the lead gen forms owned by {owner}.

Show the next {count} lead forms for {owner} starting at {start}.

GET /leadFormResponses Pull lead form responses on a schedule · LinkedIn 8. Schedule Periodic Form Response (lead) Pulls #

Ask an LLM

“How can I pull all new leads for a sponsored account on a recurring schedule?”

“Can I exclude test leads when fetching form responses?”

Tell an agent

Pull every lead form response for {owner} submitted in {submittedAtTimeRange}.

Fetch {leadType} leads for {owner}, skipping test leads when {limitedToTestLeads} is false.

POST /leadNotifications Register a webhook for new lead notifications · LinkedIn 8. Subscribe for Lead Notification Webhooks #

Ask an LLM

“Can I get a webhook call whenever a new lead form is submitted?”

“What does it take to subscribe to real-time lead notifications instead of polling?”

Tell an agent

Register a lead notification webhook for my sponsored account.

Subscribe my integration to push notifications for new leads.

GET /leadFormResponses/{lead_id} Fetch one lead's full form response · LinkedIn 9. Fetch Full Lead Data After a Lead Notification is Received #

Ask an LLM

“After a lead webhook fires, how do I get the full answers for that lead?”

“Can I retrieve a single form response by its lead ID?”

Tell an agent

Fetch the full form response for lead {lead_id}.

Get lead {lead_id} with only the fields {fields}.

DELETE /leadnotifications/ Delete a registered lead notification webhook · LinkedIn [PUSH] Delete a Registered Webhook by Id #

Ask an LLM

“Can I remove a lead notification webhook I registered earlier?”

“What happens to lead webhooks when my integration is uninstalled?”

Tell an agent destructive · confirm first

Delete my registered lead notification webhook subscription.

Stop lead push notifications by removing the webhook.

GET /adAccounts Search the user's sponsored ad accounts · LinkedIn 2. Get the User's Sponsored Accounts (ad Accounts) #

Ask an LLM

“Which sponsored ad accounts can the signed-in user choose from for lead sync?”

“Can I search the user's ad accounts and return only certain fields?”

Tell an agent

Search the user's sponsored accounts matching {search}.

List {count} sponsored ad accounts from offset {start}.

Documentation

https://learn.microsoft.com/en-us/linkedin/marketing/

https://learn.microsoft.com/en-us/linkedin/marketing/getting-started

https://learn.microsoft.com/en-us/linkedin/learning/

https://learn.microsoft.com/en-us/linkedin/learning/getting-started

https://learn.microsoft.com/en-us/linkedin/learning/getting-started/terminology

https://learn.microsoft.com/en-us/linkedin/learning/integrations/xapi

https://learn.microsoft.com/en-us/linkedin/learning/reporting/reporting-docs/reporting-api

https://learn.microsoft.com/en-us/linkedin/talent/

https://learn.microsoft.com/en-us/linkedin/talent/getting-started

https://learn.microsoft.com/en-us/linkedin/talent/versioning

https://learn.microsoft.com/en-us/linkedin/compliance/

https://learn.microsoft.com/en-us/linkedin/compliance/getting-started

https://learn.microsoft.com/en-us/linkedin/compliance/compliance-api/overview

https://learn.microsoft.com/en-us/linkedin/sales/

https://learn.microsoft.com/en-us/linkedin/sales/display-services/

https://learn.microsoft.com/en-us/linkedin/sales/analytics-services/

https://learn.microsoft.com/en-us/linkedin/sales/sync-services/

https://learn.microsoft.com/en-us/linkedin/dma/

https://learn.microsoft.com/en-us/linkedin/dma/member-data-portability/

https://learn.microsoft.com/en-us/linkedin/dma/pages-data-portability-overview

https://learn.microsoft.com/en-us/linkedin/dma/transparency/advertiser-transparency

Specifications

https://raw.githubusercontent.com/api-evangelist/linkedin/refs/heads/main/openapi/linkedin-use-cases-sponsored-api-openapi.yml

Other Resources

https://learn.microsoft.com/en-us/linkedin/marketing/usecases/

https://learn.microsoft.com/en-us/linkedin/marketing/integrations/recent-changes

https://learn.microsoft.com/en-us/linkedin/marketing/lms-faq

PostmanWorkspace

https://www.postman.com/linkedin-developer-apis/workspace/linkedin-marketing-solutions-versioned-apis/overview

https://learn.microsoft.com/en-us/linkedin/learning/integrations/release-notes

PostmanWorkspace

https://www.postman.com/linkedin-developer-apis/workspace/linkedin-learning-solutions/overview

https://learn.microsoft.com/en-us/linkedin/talent/release-notes

PostmanWorkspace

https://www.postman.com/linkedin-developer-apis/workspace/linkedin-talent-solutions/overview

https://learn.microsoft.com/en-us/linkedin/compliance/release-notes

https://learn.microsoft.com/en-us/linkedin/compliance/compliance-api/compliance-faq

PostmanWorkspace

https://www.postman.com/linkedin-developer-apis/workspace/linkedin-compliance-solutions/overview

https://learn.microsoft.com/en-us/linkedin/dma/transparency/advertiser-transparency-faq

https://learn.microsoft.com/en-us/linkedin/dma/recent-changes

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/linkedin:linkedin-use-cases-sponsored-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Lead Sync Use Cases > Sponsored API
  description: 'This collection aims to focus on different lead syncing use cases and should be used with the **lead-sync-env-versioning** environment.


    _All requests for the Lead Sync collection are in the Restli 2.0 format and uses OAuth 2.0_'
  version: 1.0.0
servers:
- url: https://api.linkedin.com
  description: LinkedIn Marketing API Production Server
security:
- oauth2Auth: []
tags:


# --- truncated at 32 KB (49 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/linkedin/refs/heads/main/openapi/linkedin-use-cases-sponsored-api-openapi.yml