How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

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

LinkedIn Use Cases > Sponsored API is one of 65 APIs that LinkedIn publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Use Cases > Sponsored. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, a changelog, release notes, and an API reference.

This API exposes 7 operations across 7 paths, and defines 5 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://api.linkedin.com.

7 operations 7 paths 5 schemas 1 DELETE5 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.linkedin.com
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

LinkedIn Use Cases > Sponsored API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth2Auth) using the authorizationCode flow, exposing 1 scope. By default, every request must be authenticated.

Paths & Operations 7

Across 7 paths, the API surfaces 7 operations — 1 DELETE, 5 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Use Cases > Sponsored 7

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 fo…

GET
/organizationAcls
LinkedIn 4. Validate the User's Organization Role
getValidateTheUsersOrganization 4 params → 200
GET
/leadForms
LinkedIn 5. Get Forms for the Chosen Sponsored Account
getGetFormsForThe 6 params → 200
GET
/leadFormResponses
LinkedIn 8. Schedule Periodic Form Response (lead) Pulls
getSchedulePeriodicFormResponse 10 params → 200
POST
/leadNotifications
LinkedIn 8. Subscribe for Lead Notification Webhooks
postSubscribeForLeadNotification 2 params body → 200
GET
/leadFormResponses/{lead_id}
LinkedIn 9. Fetch Full Lead Data After a Lead Notification is Received
getFetchFullLeadData 5 params → 200
DELETE
/leadnotifications/
LinkedIn [PUSH] Delete a Registered Webhook by Id
deletePushDeleteARegistered 2 params → 200
GET
/adAccounts
LinkedIn 2. Get the User's Sponsored Accounts (ad Accounts)
getGetTheUsersSponsored 7 params → 200

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are FetchFullLeadDataResponse200 (10 properties), GetTheUsersSponsoredResponse200 (2 properties), GetFormsForTheResponse200 (2 properties), ValidateTheUsersOrganizationResponse200 (2 properties). Each schema is shown below with its type and property counts.

FetchFullLeadDataResponse200
object
10 properties
SubscribeForLeadNotificationRequest
object
ValidateTheUsersOrganizationResponse200
object
2 properties
GetFormsForTheResponse200
object
2 properties
GetTheUsersSponsoredResponse200
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

linkedin-use-cases-sponsored-api-openapi.yml Raw ↑

Other APIs LinkedIn publishes across the network.

LinkedIn Consumer API
LinkedIn Access Control API
LinkedIn Account Management API
LinkedIn Ad Accounts API
LinkedIn Ad Targeting Entities API
LinkedIn Advertiser Transparency API
LinkedIn Application Retrieval API
LinkedIn Application Synchronization API
LinkedIn Application Updates API
LinkedIn Apply Connect Jobs API
LinkedIn Audience Counts API
LinkedIn Audience Insights API
Where this information came from

This is an independent, third-party profile of LinkedIn Use Cases > Sponsored API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.