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
Supports authentication: OAuth 2.0
Tool list
Section titled “Tool list”linkedin_ad_account_create
Section titled “linkedin_ad_account_create”Create a new LinkedIn ad account for running advertising campaigns.
| Name | Type | Required | Description |
|---|---|---|---|
currency | string | Yes | The currency code for the ad account (e.g. ‘USD’, ‘EUR’). |
name | string | Yes | The name of the new ad account. |
reference | string | Yes | Reference URN for the account owner (e.g. organization URN ‘urn:li:organization:12345’). |
linkedin_ad_account_get
Section titled “linkedin_ad_account_get”Get a LinkedIn ad account by its ID.
| Name | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | The ID of the ad account to retrieve. |
linkedin_ad_account_update
Section titled “linkedin_ad_account_update”Partially update a LinkedIn ad account’s name or status.
| Name | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | The ID of the ad account to update. |
name | string | No | New name for the ad account. |
status | string | No | New status for the ad account (e.g. ACTIVE, CANCELED). |
linkedin_ad_account_users_list
Section titled “linkedin_ad_account_users_list”List all users who have access to a LinkedIn ad account.
| Name | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | The ID of the ad account to list users for. |
linkedin_ad_accounts_search
Section titled “linkedin_ad_accounts_search”Search LinkedIn ad accounts by status or name.
| Name | Type | Required | Description |
|---|---|---|---|
name | string | No | Filter by account name (partial match). |
status | string | No | Filter by account status. One of: ACTIVE, CANCELED, DRAFT. |
linkedin_ad_analytics_get
Section titled “linkedin_ad_analytics_get”Get campaign analytics data for a LinkedIn ad campaign including impressions, clicks, and spend.
| Name | Type | Required | Description |
|---|---|---|---|
campaigns | string | Yes | The campaign URN to retrieve analytics for (e.g. ‘urn:li:sponsoredCampaign:712345678’). |
date_range_end | string | Yes | End date for the analytics period (YYYY-MM-DD format). |
date_range_start | string | Yes | Start date for the analytics period (YYYY-MM-DD format). |
time_granularity | string | Yes | Granularity of the analytics data. One of: DAILY, MONTHLY, ALL. |
linkedin_asset_get
Section titled “linkedin_asset_get”Get the status and details of an uploaded LinkedIn media asset.
| Name | Type | Required | Description |
|---|---|---|---|
asset_id | string | Yes | The ID of the media asset to retrieve. |
linkedin_campaign_create
Section titled “linkedin_campaign_create”Create a new ad campaign within a LinkedIn ad account.
| Name | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | The ID of the ad account to create the campaign in. |
campaign_group_id | string | Yes | The ID of the campaign group this campaign belongs to. |
cost_type | string | Yes | The cost type for the campaign (e.g. ‘CPM’, ‘CPC’, ‘CPV’). |
daily_budget_amount | string | Yes | The daily budget amount as a decimal string (e.g. ‘100.00’). |
daily_budget_currency | string | Yes | The currency code for the daily budget (e.g. ‘USD’, ‘EUR’). |
name | string | Yes | The name of the campaign. |
objective_type | string | Yes | The objective type for the campaign (e.g. ‘AWARENESS’, ‘WEBSITE_VISIT’, ‘LEAD_GENERATION’). |
linkedin_campaign_delete
Section titled “linkedin_campaign_delete”Delete a DRAFT LinkedIn ad campaign. Only campaigns in DRAFT status can be deleted.
| Name | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | The ID of the ad account that owns the campaign. |
campaign_id | string | Yes | The ID of the DRAFT campaign to delete. |
linkedin_campaign_get
Section titled “linkedin_campaign_get”Get a specific ad campaign by ID within a LinkedIn ad account.
| Name | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | The ID of the ad account that owns the campaign. |
campaign_id | string | Yes | The ID of the campaign to retrieve. |
linkedin_campaign_group_create
Section titled “linkedin_campaign_group_create”Create a new campaign group within a LinkedIn ad account.
| Name | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | The ID of the ad account to create the campaign group in. |
name | string | Yes | The name of the campaign group. |
status | string | No | Status of the campaign group. One of: ACTIVE, ARCHIVED, CANCELED, DRAFT, PAUSED. Defaults to ACTIVE. |
linkedin_campaign_group_get
Section titled “linkedin_campaign_group_get”Get a specific campaign group by ID within a LinkedIn ad account.
| Name | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | The ID of the ad account that owns the campaign group. |
group_id | string | Yes | The ID of the campaign group to retrieve. |
linkedin_campaign_group_update
Section titled “linkedin_campaign_group_update”Partially update a LinkedIn campaign group’s name or status.
| Name | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | The ID of the ad account that owns the campaign group. |
group_id | string | Yes | The ID of the campaign group to update. |
name | string | No | New name for the campaign group. |
status | string | No | New status for the campaign group (e.g. ACTIVE, PAUSED, ARCHIVED). |
linkedin_campaign_groups_list
Section titled “linkedin_campaign_groups_list”List campaign groups for a LinkedIn ad account.
| Name | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | The ID of the ad account to list campaign groups for. |
count | integer | No | Number of results to return per page. |
start | integer | No | Offset for pagination. |
status | string | No | Filter by campaign group status (e.g. ACTIVE, PAUSED, ARCHIVED). |
linkedin_campaign_update
Section titled “linkedin_campaign_update”Partially update a LinkedIn ad campaign’s name or status.
| Name | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | The ID of the ad account that owns the campaign. |
campaign_id | string | Yes | The ID of the campaign to update. |
name | string | No | New name for the campaign. |
status | string | No | New status for the campaign (e.g. ACTIVE, PAUSED, ARCHIVED, CANCELED). |
linkedin_campaigns_list
Section titled “linkedin_campaigns_list”List ad campaigns for a LinkedIn ad account.
| Name | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | The ID of the ad account to list campaigns for. |
count | integer | No | Number of results to return per page. |
start | integer | No | Offset for pagination. |
status | string | No | Filter by campaign status (e.g. ACTIVE, PAUSED, ARCHIVED, CANCELED, DRAFT). |
linkedin_comment_delete
Section titled “linkedin_comment_delete”Delete a specific comment on a LinkedIn post.
| Name | Type | Required | Description |
|---|---|---|---|
actor_urn | string | Yes | The URN of the actor (person) deleting the comment. |
comment_id | string | Yes | The ID of the comment to delete. |
entity_urn | string | Yes | The URN of the post the comment belongs to. |
linkedin_comment_get
Section titled “linkedin_comment_get”Get a specific comment on a LinkedIn post by entity URN and comment ID.
| Name | Type | Required | Description |
|---|---|---|---|
comment_id | string | Yes | The ID of the comment to retrieve. |
entity_urn | string | Yes | The URN of the post the comment belongs to. |
linkedin_creative_create
Section titled “linkedin_creative_create”Create a new ad creative for a LinkedIn ad campaign.
| Name | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | The ID of the ad account to create the creative in. |
campaign_id | string | Yes | The campaign URN this creative belongs to (e.g. ‘urn:li:sponsoredCampaign:712345678’). |
name | string | Yes | The name of the creative. |
status | string | No | Status of the creative. Defaults to ACTIVE. |
linkedin_creative_get
Section titled “linkedin_creative_get”Get a specific ad creative by ID within a LinkedIn ad account.
| Name | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | The ID of the ad account that owns the creative. |
creative_id | string | Yes | The ID of the creative to retrieve. |
linkedin_creative_update
Section titled “linkedin_creative_update”Partially update a LinkedIn ad creative’s name or status.
| Name | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | The ID of the ad account that owns the creative. |
creative_id | string | Yes | The ID of the creative to update. |
name | string | No | New name for the creative. |
status | string | No | New status for the creative (e.g. ACTIVE, PAUSED, ARCHIVED). |
linkedin_creatives_list
Section titled “linkedin_creatives_list”List ad creatives for a LinkedIn ad account, with optional filtering by campaign or status.
| Name | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | The ID of the ad account to list creatives for. |
campaign_id | string | No | Filter creatives by campaign URN. |
count | integer | No | Number of results to return per page. |
start | integer | No | Offset for pagination. |
status | string | No | Filter by creative status (e.g. ACTIVE, PAUSED, ARCHIVED). |
linkedin_email_get
Section titled “linkedin_email_get”Retrieve the authenticated user’s primary email address from LinkedIn.
linkedin_job_posting_get
Section titled “linkedin_job_posting_get”Get details of a specific LinkedIn job posting by its ID.
| Name | Type | Required | Description |
|---|---|---|---|
job_id | string | Yes | The ID of the job posting to retrieve. |
linkedin_media_upload_register
Section titled “linkedin_media_upload_register”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.
| Name | Type | Required | Description |
|---|---|---|---|
owner_urn | string | Yes | The URN of the person or organization that owns the media (e.g. ‘urn:li:person:{id}’). |
recipe | string | Yes | The media recipe type. One of: feedshare-image, feedshare-video, messaging-attachment. |
linkedin_member_search
Section titled “linkedin_member_search”Search LinkedIn members by keyword for at-mention typeahead (requires Marketing API access).
| Name | Type | Required | Description |
|---|---|---|---|
count | integer | No | Number of results to return. |
keywords | string | Yes | Keywords to search for members. |
linkedin_message_create
Section titled “linkedin_message_create”Send a LinkedIn message via the Messaging API (requires LinkedIn Messaging API partner access). Uses /rest/messages endpoint.
| Name | Type | Required | Description |
|---|---|---|---|
body | string | Yes | The text content of the message. |
recipients | string | Yes | Comma-separated list of recipient person URNs (e.g. ‘urn:li:person:abc123,urn:li:person:def456’). |
subject | string | No | Optional subject line for the message. |
linkedin_organization_access_control_list
Section titled “linkedin_organization_access_control_list”List organizations where the authenticated user has admin access via the Organizational Entity ACLs API.
| Name | Type | Required | Description |
|---|---|---|---|
role_assignee_urn | string | Yes | URN of the person whose org access to check, e.g. urn:li:person:{id}. |
linkedin_organization_admins_get
Section titled “linkedin_organization_admins_get”List administrators of a LinkedIn organization page using the Organizational Entity ACLs API.
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Numeric LinkedIn organization ID. |
linkedin_organization_by_vanity_get
Section titled “linkedin_organization_by_vanity_get”Find a LinkedIn organization by its vanity name (the custom URL slug used in the company’s LinkedIn URL).
| Name | Type | Required | Description |
|---|---|---|---|
vanity_name | string | Yes | The vanity name (URL slug) of the organization to look up. |
linkedin_organization_followers_count
Section titled “linkedin_organization_followers_count”Get the follower count for a LinkedIn organization using its URL-encoded URN.
| Name | Type | Required | Description |
|---|---|---|---|
organization_urn | string | Yes | URL-encoded URN of the organization, e.g. urn%3Ali%3Aorganization%3A{id}. |
linkedin_organization_get
Section titled “linkedin_organization_get”Retrieve details of a LinkedIn organization (company page) by its numeric ID.
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The numeric ID of the LinkedIn organization. |
linkedin_organization_post_create
Section titled “linkedin_organization_post_create”Create a UGC post on behalf of a LinkedIn organization. The post will appear on the organization’s page.
| Name | Type | Required | Description |
|---|---|---|---|
organization_id | string | Yes | The numeric ID of the organization to post on behalf of. |
text | string | Yes | The text content of the post. |
visibility | string | No | Visibility of the post. PUBLIC or CONNECTIONS. |
linkedin_organization_search
Section titled “linkedin_organization_search”Search LinkedIn organizations by keyword using the company search API.
| Name | Type | Required | Description |
|---|---|---|---|
count | integer | No | Number of results to return. |
keywords | string | Yes | Keywords to search for organizations. |
linkedin_organizations_batch_get
Section titled “linkedin_organizations_batch_get”Batch get multiple LinkedIn organizations by their numeric IDs. Works without admin access.
| Name | Type | Required | Description |
|---|---|---|---|
ids | string | Yes | Comma-separated list of organization IDs to retrieve (e.g. ‘12345,67890’). |
linkedin_post_comment_create
Section titled “linkedin_post_comment_create”Add a comment to a LinkedIn UGC post on behalf of a member.
| Name | Type | Required | Description |
|---|---|---|---|
actor | string | Yes | URN of the member leaving the comment, e.g. urn:li:person:{id}. |
text | string | Yes | The text content of the comment. |
ugc_post_urn | string | Yes | URL-encoded URN of the UGC post to comment on, e.g. urn%3Ali%3AugcPost%3A{id}. |
linkedin_post_comments_list
Section titled “linkedin_post_comments_list”List comments on a LinkedIn UGC post.
| Name | Type | Required | Description |
|---|---|---|---|
count | integer | No | Maximum number of comments to return. |
start | integer | No | Pagination start index (0-based offset). |
ugc_post_urn | string | Yes | URL-encoded URN of the UGC post to retrieve comments for, e.g. urn%3Ali%3AugcPost%3A{id}. |
linkedin_post_create
Section titled “linkedin_post_create”Create a UGC post on LinkedIn on behalf of the authenticated user or organization.
| Name | Type | Required | Description |
|---|---|---|---|
author | string | Yes | URN of the post author, e.g. urn:li:person:{id} or urn:li:organization:{id}. |
text | string | Yes | The text content of the post. |
visibility | string | No | Visibility of the post. Options: PUBLIC, CONNECTIONS. Defaults to PUBLIC. |
linkedin_post_delete
Section titled “linkedin_post_delete”Delete a UGC post from LinkedIn by its ID. This action is irreversible.
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | URL-encoded post URN, e.g. urn%3Ali%3AugcPost%3A12345. |
linkedin_post_get
Section titled “linkedin_post_get”Get a specific LinkedIn post by its URL-encoded URN (e.g. urn%3Ali%3AugcPost%3A12345).
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | URL-encoded post URN, e.g. urn%3Ali%3AugcPost%3A12345. |
linkedin_post_like
Section titled “linkedin_post_like”Like a LinkedIn post on behalf of a person or organization. Uses the Reactions API.
| Name | Type | Required | Description |
|---|---|---|---|
actor_urn | string | Yes | URN of the person or org liking the post, e.g. urn:li:person:{id}. |
entity_urn | string | Yes | URN of the post to like, e.g. urn:li:ugcPost:{id} or urn:li:share:{id}. |
linkedin_posts_list
Section titled “linkedin_posts_list”List posts by a specific author (person or organization URN).
| Name | Type | Required | Description |
|---|---|---|---|
author | string | Yes | URL-encoded author URN, e.g. urn%3Ali%3Aperson%3A{id} or urn%3Ali%3Aorganization%3A{id}. |
count | integer | No | Maximum number of results to return. |
start | integer | No | Pagination start index (0-based offset). |
linkedin_profile_get
Section titled “linkedin_profile_get”Retrieve the current authenticated user’s LinkedIn profile including first name, last name, ID, and profile picture.
linkedin_reaction_create
Section titled “linkedin_reaction_create”Create a reaction (like, praise, empathy, etc.) on a LinkedIn post or comment.
| Name | Type | Required | Description |
|---|---|---|---|
actor_urn | string | Yes | The URN of the person reacting (e.g. ‘urn:li:person:abc123’). |
entity_urn | string | Yes | The URN of the post or comment to react to. |
reaction_type | string | Yes | The type of reaction. One of: LIKE, PRAISE, EMPATHY, INTEREST, APPRECIATION, ENTERTAINMENT. |
linkedin_reaction_delete
Section titled “linkedin_reaction_delete”Delete a reaction from a LinkedIn post or comment.
| Name | Type | Required | Description |
|---|---|---|---|
actor_urn | string | Yes | The URN of the person whose reaction is being deleted (e.g. ‘urn:li:person:abc123’). |
entity_urn | string | Yes | The URN of the post or comment the reaction was made on. |
linkedin_reactions_list
Section titled “linkedin_reactions_list”List all reactions on a LinkedIn post or entity.
| Name | Type | Required | Description |
|---|---|---|---|
count | integer | No | Number of reactions to return per page. |
entity_urn | string | Yes | The URN of the post or entity to list reactions for. |
start | integer | No | Offset for pagination. |
linkedin_share_create
Section titled “linkedin_share_create”Create a post on LinkedIn on behalf of a person or organization.
| Name | Type | Required | Description |
|---|---|---|---|
owner | string | Yes | URN of the share owner, e.g. urn:li:person:{id} or urn:li:organization:{id}. |
text | string | Yes | The text content of the share. |
visibility_code | string | No | Visibility of the share. Options: anyone, connectionsOnly. Defaults to anyone. |
linkedin_social_metadata_get
Section titled “linkedin_social_metadata_get”Get engagement metadata (likes, comments, reaction counts) for a post or share by its URN.
| Name | Type | Required | Description |
|---|---|---|---|
share_urn | string | Yes | URL-encoded post/share URN, e.g. urn%3Ali%3AugcPost%3A12345. |
linkedin_userinfo_get
Section titled “linkedin_userinfo_get”Get the authenticated user’s OpenID Connect userinfo including id, name, email, and profile picture.