Skip to content
Talk to an Engineer Dashboard

LinkedIn

Connect to LinkedIn to manage user authentication, profile data, email, and professional identity via OAuth 2.0

Connect to LinkedIn to manage user authentication, profile data, email, and professional identity via OAuth 2.0

LinkedIn logo

Supports authentication: OAuth 2.0

Create a new LinkedIn ad account for running advertising campaigns.

NameTypeRequiredDescription
currencystringYesThe currency code for the ad account (e.g. ‘USD’, ‘EUR’).
namestringYesThe name of the new ad account.
referencestringYesReference URN for the account owner (e.g. organization URN ‘urn:li:organization:12345’).

Get a LinkedIn ad account by its ID.

NameTypeRequiredDescription
account_idstringYesThe ID of the ad account to retrieve.

Partially update a LinkedIn ad account’s name or status.

NameTypeRequiredDescription
account_idstringYesThe ID of the ad account to update.
namestringNoNew name for the ad account.
statusstringNoNew status for the ad account (e.g. ACTIVE, CANCELED).

List all users who have access to a LinkedIn ad account.

NameTypeRequiredDescription
account_idstringYesThe ID of the ad account to list users for.

Search LinkedIn ad accounts by status or name.

NameTypeRequiredDescription
namestringNoFilter by account name (partial match).
statusstringNoFilter by account status. One of: ACTIVE, CANCELED, DRAFT.

Get campaign analytics data for a LinkedIn ad campaign including impressions, clicks, and spend.

NameTypeRequiredDescription
campaignsstringYesThe campaign URN to retrieve analytics for (e.g. ‘urn:li:sponsoredCampaign:712345678’).
date_range_endstringYesEnd date for the analytics period (YYYY-MM-DD format).
date_range_startstringYesStart date for the analytics period (YYYY-MM-DD format).
time_granularitystringYesGranularity of the analytics data. One of: DAILY, MONTHLY, ALL.

Get the status and details of an uploaded LinkedIn media asset.

NameTypeRequiredDescription
asset_idstringYesThe ID of the media asset to retrieve.

Create a new ad campaign within a LinkedIn ad account.

NameTypeRequiredDescription
account_idstringYesThe ID of the ad account to create the campaign in.
campaign_group_idstringYesThe ID of the campaign group this campaign belongs to.
cost_typestringYesThe cost type for the campaign (e.g. ‘CPM’, ‘CPC’, ‘CPV’).
daily_budget_amountstringYesThe daily budget amount as a decimal string (e.g. ‘100.00’).
daily_budget_currencystringYesThe currency code for the daily budget (e.g. ‘USD’, ‘EUR’).
namestringYesThe name of the campaign.
objective_typestringYesThe objective type for the campaign (e.g. ‘AWARENESS’, ‘WEBSITE_VISIT’, ‘LEAD_GENERATION’).

Delete a DRAFT LinkedIn ad campaign. Only campaigns in DRAFT status can be deleted.

NameTypeRequiredDescription
account_idstringYesThe ID of the ad account that owns the campaign.
campaign_idstringYesThe ID of the DRAFT campaign to delete.

Get a specific ad campaign by ID within a LinkedIn ad account.

NameTypeRequiredDescription
account_idstringYesThe ID of the ad account that owns the campaign.
campaign_idstringYesThe ID of the campaign to retrieve.

Create a new campaign group within a LinkedIn ad account.

NameTypeRequiredDescription
account_idstringYesThe ID of the ad account to create the campaign group in.
namestringYesThe name of the campaign group.
statusstringNoStatus of the campaign group. One of: ACTIVE, ARCHIVED, CANCELED, DRAFT, PAUSED. Defaults to ACTIVE.

Get a specific campaign group by ID within a LinkedIn ad account.

NameTypeRequiredDescription
account_idstringYesThe ID of the ad account that owns the campaign group.
group_idstringYesThe ID of the campaign group to retrieve.

Partially update a LinkedIn campaign group’s name or status.

NameTypeRequiredDescription
account_idstringYesThe ID of the ad account that owns the campaign group.
group_idstringYesThe ID of the campaign group to update.
namestringNoNew name for the campaign group.
statusstringNoNew status for the campaign group (e.g. ACTIVE, PAUSED, ARCHIVED).

List campaign groups for a LinkedIn ad account.

NameTypeRequiredDescription
account_idstringYesThe ID of the ad account to list campaign groups for.
countintegerNoNumber of results to return per page.
startintegerNoOffset for pagination.
statusstringNoFilter by campaign group status (e.g. ACTIVE, PAUSED, ARCHIVED).

Partially update a LinkedIn ad campaign’s name or status.

NameTypeRequiredDescription
account_idstringYesThe ID of the ad account that owns the campaign.
campaign_idstringYesThe ID of the campaign to update.
namestringNoNew name for the campaign.
statusstringNoNew status for the campaign (e.g. ACTIVE, PAUSED, ARCHIVED, CANCELED).

List ad campaigns for a LinkedIn ad account.

NameTypeRequiredDescription
account_idstringYesThe ID of the ad account to list campaigns for.
countintegerNoNumber of results to return per page.
startintegerNoOffset for pagination.
statusstringNoFilter by campaign status (e.g. ACTIVE, PAUSED, ARCHIVED, CANCELED, DRAFT).

Delete a specific comment on a LinkedIn post.

NameTypeRequiredDescription
actor_urnstringYesThe URN of the actor (person) deleting the comment.
comment_idstringYesThe ID of the comment to delete.
entity_urnstringYesThe URN of the post the comment belongs to.

Get a specific comment on a LinkedIn post by entity URN and comment ID.

NameTypeRequiredDescription
comment_idstringYesThe ID of the comment to retrieve.
entity_urnstringYesThe URN of the post the comment belongs to.

Create a new ad creative for a LinkedIn ad campaign.

NameTypeRequiredDescription
account_idstringYesThe ID of the ad account to create the creative in.
campaign_idstringYesThe campaign URN this creative belongs to (e.g. ‘urn:li:sponsoredCampaign:712345678’).
namestringYesThe name of the creative.
statusstringNoStatus of the creative. Defaults to ACTIVE.

Get a specific ad creative by ID within a LinkedIn ad account.

NameTypeRequiredDescription
account_idstringYesThe ID of the ad account that owns the creative.
creative_idstringYesThe ID of the creative to retrieve.

Partially update a LinkedIn ad creative’s name or status.

NameTypeRequiredDescription
account_idstringYesThe ID of the ad account that owns the creative.
creative_idstringYesThe ID of the creative to update.
namestringNoNew name for the creative.
statusstringNoNew status for the creative (e.g. ACTIVE, PAUSED, ARCHIVED).

List ad creatives for a LinkedIn ad account, with optional filtering by campaign or status.

NameTypeRequiredDescription
account_idstringYesThe ID of the ad account to list creatives for.
campaign_idstringNoFilter creatives by campaign URN.
countintegerNoNumber of results to return per page.
startintegerNoOffset for pagination.
statusstringNoFilter by creative status (e.g. ACTIVE, PAUSED, ARCHIVED).

Retrieve the authenticated user’s primary email address from LinkedIn.

Get details of a specific LinkedIn job posting by its ID.

NameTypeRequiredDescription
job_idstringYesThe ID of the job posting to retrieve.

Register a media asset upload with LinkedIn (step 1 of image/video upload). Returns an upload URL and asset ID to use for subsequent upload steps.

NameTypeRequiredDescription
owner_urnstringYesThe URN of the person or organization that owns the media (e.g. ‘urn:li:person:{id}’).
recipestringYesThe media recipe type. One of: feedshare-image, feedshare-video, messaging-attachment.

Search LinkedIn members by keyword for at-mention typeahead (requires Marketing API access).

NameTypeRequiredDescription
countintegerNoNumber of results to return.
keywordsstringYesKeywords to search for members.

Send a LinkedIn message via the Messaging API (requires LinkedIn Messaging API partner access). Uses /rest/messages endpoint.

NameTypeRequiredDescription
bodystringYesThe text content of the message.
recipientsstringYesComma-separated list of recipient person URNs (e.g. ‘urn:li:person:abc123,urn:li:person:def456’).
subjectstringNoOptional subject line for the message.

List organizations where the authenticated user has admin access via the Organizational Entity ACLs API.

NameTypeRequiredDescription
role_assignee_urnstringYesURN of the person whose org access to check, e.g. urn:li:person:{id}.

List administrators of a LinkedIn organization page using the Organizational Entity ACLs API.

NameTypeRequiredDescription
idstringYesNumeric LinkedIn organization ID.

Find a LinkedIn organization by its vanity name (the custom URL slug used in the company’s LinkedIn URL).

NameTypeRequiredDescription
vanity_namestringYesThe vanity name (URL slug) of the organization to look up.

Get the follower count for a LinkedIn organization using its URL-encoded URN.

NameTypeRequiredDescription
organization_urnstringYesURL-encoded URN of the organization, e.g. urn%3Ali%3Aorganization%3A{id}.

Retrieve details of a LinkedIn organization (company page) by its numeric ID.

NameTypeRequiredDescription
idstringYesThe numeric ID of the LinkedIn organization.

Create a UGC post on behalf of a LinkedIn organization. The post will appear on the organization’s page.

NameTypeRequiredDescription
organization_idstringYesThe numeric ID of the organization to post on behalf of.
textstringYesThe text content of the post.
visibilitystringNoVisibility of the post. PUBLIC or CONNECTIONS.

Search LinkedIn organizations by keyword using the company search API.

NameTypeRequiredDescription
countintegerNoNumber of results to return.
keywordsstringYesKeywords to search for organizations.

Batch get multiple LinkedIn organizations by their numeric IDs. Works without admin access.

NameTypeRequiredDescription
idsstringYesComma-separated list of organization IDs to retrieve (e.g. ‘12345,67890’).

Add a comment to a LinkedIn UGC post on behalf of a member.

NameTypeRequiredDescription
actorstringYesURN of the member leaving the comment, e.g. urn:li:person:{id}.
textstringYesThe text content of the comment.
ugc_post_urnstringYesURL-encoded URN of the UGC post to comment on, e.g. urn%3Ali%3AugcPost%3A{id}.

List comments on a LinkedIn UGC post.

NameTypeRequiredDescription
countintegerNoMaximum number of comments to return.
startintegerNoPagination start index (0-based offset).
ugc_post_urnstringYesURL-encoded URN of the UGC post to retrieve comments for, e.g. urn%3Ali%3AugcPost%3A{id}.

Create a UGC post on LinkedIn on behalf of the authenticated user or organization.

NameTypeRequiredDescription
authorstringYesURN of the post author, e.g. urn:li:person:{id} or urn:li:organization:{id}.
textstringYesThe text content of the post.
visibilitystringNoVisibility of the post. Options: PUBLIC, CONNECTIONS. Defaults to PUBLIC.

Delete a UGC post from LinkedIn by its ID. This action is irreversible.

NameTypeRequiredDescription
idstringYesURL-encoded post URN, e.g. urn%3Ali%3AugcPost%3A12345.

Get a specific LinkedIn post by its URL-encoded URN (e.g. urn%3Ali%3AugcPost%3A12345).

NameTypeRequiredDescription
idstringYesURL-encoded post URN, e.g. urn%3Ali%3AugcPost%3A12345.

Like a LinkedIn post on behalf of a person or organization. Uses the Reactions API.

NameTypeRequiredDescription
actor_urnstringYesURN of the person or org liking the post, e.g. urn:li:person:{id}.
entity_urnstringYesURN of the post to like, e.g. urn:li:ugcPost:{id} or urn:li:share:{id}.

List posts by a specific author (person or organization URN).

NameTypeRequiredDescription
authorstringYesURL-encoded author URN, e.g. urn%3Ali%3Aperson%3A{id} or urn%3Ali%3Aorganization%3A{id}.
countintegerNoMaximum number of results to return.
startintegerNoPagination start index (0-based offset).

Retrieve the current authenticated user’s LinkedIn profile including first name, last name, ID, and profile picture.

Create a reaction (like, praise, empathy, etc.) on a LinkedIn post or comment.

NameTypeRequiredDescription
actor_urnstringYesThe URN of the person reacting (e.g. ‘urn:li:person:abc123’).
entity_urnstringYesThe URN of the post or comment to react to.
reaction_typestringYesThe type of reaction. One of: LIKE, PRAISE, EMPATHY, INTEREST, APPRECIATION, ENTERTAINMENT.

Delete a reaction from a LinkedIn post or comment.

NameTypeRequiredDescription
actor_urnstringYesThe URN of the person whose reaction is being deleted (e.g. ‘urn:li:person:abc123’).
entity_urnstringYesThe URN of the post or comment the reaction was made on.

List all reactions on a LinkedIn post or entity.

NameTypeRequiredDescription
countintegerNoNumber of reactions to return per page.
entity_urnstringYesThe URN of the post or entity to list reactions for.
startintegerNoOffset for pagination.

Create a post on LinkedIn on behalf of a person or organization.

NameTypeRequiredDescription
ownerstringYesURN of the share owner, e.g. urn:li:person:{id} or urn:li:organization:{id}.
textstringYesThe text content of the share.
visibility_codestringNoVisibility of the share. Options: anyone, connectionsOnly. Defaults to anyone.

Get engagement metadata (likes, comments, reaction counts) for a post or share by its URN.

NameTypeRequiredDescription
share_urnstringYesURL-encoded post/share URN, e.g. urn%3Ali%3AugcPost%3A12345.

Get the authenticated user’s OpenID Connect userinfo including id, name, email, and profile picture.