linked-in

name

linked-in

description

LinkedIn is a professional networking platform where users can connect, share industry knowledge, and discover job opportunities. It's also widely used for recruiting and B2B marketing. Read and write LinkedIn data through One: creatives, posts, dmpsegments, adcampaigns, adaccountusers, socialactions and more, 427 actions with real parameter documentation. Use whenever the user asks to look something up in LinkedIn, create or update a record there, or build code against the LinkedIn API.

LinkedIn through One

LinkedIn is a professional networking platform where users can connect, share industry knowledge, and discover job opportunities. It's also widely used for recruiting and B2B marketing.

One exposes LinkedIn through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform linked-in if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm LinkedIn is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real LinkedIn account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Creatives

Action	Method	Path	Action id
Batch Get Dynamic Follower Ads	GET	/rest/creatives	conn_mod_def::GKRUPiynyzg::YS43jJ_2R1CRiDfat5kKqw
Batch Get Text Ads	GET	/rest/creatives	conn_mod_def::GKRUPtzbyo8::x7gcgeWSTpuag-T1JNqmvg
Batch Get VAST Tag Video Ads	GET	/rest/creatives	conn_mod_def::GKRUPtyvlQM::Su-B3DYkQ_Ovjg2iYcMumw
Find Dynamic Follower Ad Creatives by Criteria	GET	/rest/creatives	conn_mod_def::GKRUQr5CS5o::e916aOSySu2QLW2Jobz60A
Get a Dynamic Follower Ad	GET	/rest/creatives/{{sponsoredCreativeUrn}}	conn_mod_def::GKRUQ5T0pj0::SC3PmbZrSy6yaVrGxdC3ug
Get a Dynamic Job Ad Creative	GET	/rest/creatives/{{sponsoredCreativeUrn}}	conn_mod_def::GKRUQ6l6Vvs::tOP7KDTGRdWAWvVq-QOmeQ
Get a Dynamic Spotlight Ad Creative	GET	/rest/creatives/{{sponsoredCreativeUrn}}	conn_mod_def::GKRUQ6nGBug::yXLK_MFTRm2MjhXCDIakwQ
Get a Text Ad	GET	/rest/creatives/{{sponsoredCreativeUrn}}	conn_mod_def::GKRURDcWzY8::pwac1xcdQzeRF2YlFzRYUQ
Get a VAST Tag Video Ad Creative	GET	/rest/creatives/{{sponsoredCreativeUrn}}	conn_mod_def::GKRURE-nHdg::LukzEjcZSP-DYFCgv4MYQw
Search an Ad Account's Creatives	GET	/rest/adAccounts/{{adAccountId}}/creatives	conn_mod_def::GKRUVIcQaIA::-Vqw8TBYQzm5TxC1ffjFNw
Batch Create Dynamic Follower Ads	POST	/rest/creatives	conn_mod_def::GKRUPNESiEI::TYHsCIPCQ7CvFXNjdBbXqQ
Batch Create Dynamic Job Ads

25 more Creatives actions are available through search.

Posts

Action	Method	Path	Action id
Batch Get Carousel Content for Posts	GET	/rest/posts	conn_mod_def::GKRUPkDovI0::LBV4u6YGRJ-49EI-67lNfw
Batch Get Celebration Content for Posts	GET	/rest/posts	conn_mod_def::GKRUVqEPNkY::sGkBwapIT_K3PmeVuvd4dA
Batch Get Poll Content for Multiple Posts	GET	/rest/posts	conn_mod_def::GKRUVq7ODfs::N_VrAPZ2Tj6Ce9-cH3v1JQ
Batch Get Posts	GET	/rest/posts	conn_mod_def::GKRUV10B6vA::EfsQcORuSWG1tIFwmjhCVQ
Batch Get Posts with MultiImage or Other Content Types	GET	/rest/posts	conn_mod_def::GKRUVpHaBGc::zI8w7PhwSi-LbR13ih_fhA
Find Posts by Account	GET	/rest/posts	conn_mod_def::GKRUWOBL5ig::qRaTgSeFTwqDPWbg_c7BFQ
Find Posts by Author	GET	/rest/posts	conn_mod_def::GKRUWP3XZhU::f7x-M_W5S8mqJJBYxlkeIA
Get a Post by URN	GET	/rest/posts/{{ugcPostUrn}}	conn_mod_def::GKRUQ5dyN6k::ZENd5lcmQNKouAqVaYAkzw
Get a Post by URN	GET	/rest/posts/{{encodedPostUrn}}	conn_mod_def::GKRUWZFzzxM::6IfeaM1eRruSqlGoLaTn4g
Get Carousel Content for a Post	GET	/rest/posts/{{postId}}	conn_mod_def::GKRURGBZLZw::BMmQoYrASmOHBxwteGC6_w
Get Celebration Content From a Post	GET	/rest/posts/{{postUrn}}	conn_mod_def::GKRUWM294oM::he4dIi8jSpyIC6nZ1O4xxA
Get MultiImage Content From a Post	GET	/rest/posts/{{postId}}	conn_mod_def::GKRUWdDFcek::lsbe654eSMGmhOVxlu5p5A

15 more Posts actions are available through search.

DmpSegments

Action	Method	Path	Action id
Find DMP Segments by Account	GET	/rest/dmpSegments	conn_mod_def::GKRUYMm2Hqk::IG_-S4RPQjig7wOfVkS6Pw
Get a DMP Segment	GET	/rest/dmpSegments/{{segmentId}}	conn_mod_def::GKRUYLixlpQ::E9ORLxmsRk2ggX8ILiBO9w
Get Multiple DMP Segments	GET	/rest/dmpSegments	conn_mod_def::GKRUYLjoaDk::bU8EP4fyQ2SSRcKjL3jkew
Monitor Status of a DMP Segment	GET	/rest/dmpSegments/{{dmpSegmentId}}	conn_mod_def::GKRUYYfgVYA::kt99uUqFTpGQJaXUeFNpHQ
Add or Remove a Company from a DMP Segment	POST	/rest/dmpSegments/{{dmpSegmentId}}/companies	conn_mod_def::GKRUXc6KWcY::FE5OlAt0RRKq0VnfVHoVTA
Add or Remove a User from a DMP Segment	POST	/rest/dmpSegments/{{dmpSegmentId}}/users	conn_mod_def::GKRUXpXccUc::6UCUlWCzTT2kP_3nlczJCw
Batch Delete DMP Segments	DELETE	/rest/dmpSegments	conn_mod_def::GKRUX177xho::gv57QRweQ_OPAYehtejxkg
Create a DMP Segment	POST	/rest/dmpSegments	conn_mod_def::GKRUTPWa73I::SfyP8StOQUOFSHDaM6XWMQ
Create a DMP Segment's Predictive Audience	POST	/rest/dmpSegments/{{dmpSegmentId}}/businessObjectiveBasedAudiences	conn_mod_def::GKRUYB0mpLk::O-GfS26lQ4KP-8G6lf0p3w
Create DMP Segment	POST	/rest/dmpSegments	conn_mod_def::GKRUX2VnXR8::JFAi3at1S1iZ2MrhU6QbKQ
Create List Upload DMP Segment	POST	/rest/dmpSegments	conn_mod_def::GKRUX2HUSiE::QXxFa4udTd-zVk2NDj1wBw
Delete a DMP Segment	DELETE

2 more DmpSegments actions are available through search.

AdCampaigns

Action	Method	Path	Action id
Get a Campaign for an Ad Account	GET	/rest/adAccounts/{{adAccountId}}/adCampaigns/{{campaignID}}	conn_mod_def::GKRUUmrXN2w::hiEoGVBQQnmHBmG381yvpQ
Search an Ad Account's Campaigns	GET	/rest/adAccounts/{{adAccountId}}/adCampaigns	conn_mod_def::GKRUVHf8vmY::me9iEYBJRqCfkLmDMfY6Yg
Apply Targeting to a LinkedIn Ad Campaign	POST	/rest/adAccounts/{{adAccountId}}/adCampaigns/{{campaignId}}	conn_mod_def::GKRUXp3JRM8::_kxAuFGWT_CARck5a9eQYA
Batch Create Campaigns for an Ad Account	POST	/rest/adAccounts/{{adAccountId}}/adCampaigns	conn_mod_def::GKRUUaRCto0::Vb-73wPhTrSZsWAF-tHTuw
Create a Campaign for an Event Ad Account	POST	/rest/adAccounts/{{adAccountId}}/adCampaigns	conn_mod_def::GKRUP584v2Q::jvq4U6-FSpe5MUVZkg0kGw
Create a Campaign with Offsite Delivery Enabled for an Ad Account	POST	/rest/adAccounts/{{adAccountId}}/adCampaigns	conn_mod_def::GKRUR_mYSfw::ndY-1fKMShiIPhBeb32NZA
Create an Ad Account Campaign	POST	/rest/adAccounts/{{adAccountId}}/adCampaigns	conn_mod_def::GKRUUZxhSl0::HY_IXr7aShuphNpPV72JDQ
Delete a Campaign from an Ad Account	DELETE	/rest/adAccounts/{{adAccountId}}/adCampaigns/{{campaignId}}	conn_mod_def::GKRUUbQiUcA::IE5g596FTv-K6TqVEBWLkg
Disable Offsite Delivery for an Ad Campaign	POST	/rest/adAccounts/{{adAccountId}}/adCampaigns/{{campaignId}}	conn_mod_def::GKRUSMiQLl8::4efDOZSMQ_Od17L80-66vQ
Enable Offsite Delivery for an Existing Ad Campaign	POST	/rest/adAccounts/{{adAccountId}}/adCampaigns/{{campaignId}}	conn_mod_def::GKRUSa4wBdw::N9oNWJcCQ4Gb4iUK2JK_DQ

2 more AdCampaigns actions are available through search.

AdAccountUsers

Action	Method	Path	Action id
Fetch a Specific Ad Account User	GET	/rest/adAccountUsers/(account={{account}},user={{user}})	conn_mod_def::GKRUOimnw1w::_HtjWap8T-OW75BEmc_I-A
Fetch Existing Ad Account Users	GET	/rest/adAccountUsers	conn_mod_def::GKRUOumtlWc::ydhtuRz-Rsufx1fqZvK13Q
Find Ad Accounts for the Authenticated User	GET	/rest/adAccountUsers	conn_mod_def::GKRUO3CiQaw::k9CanZAmRv-Hf9GTEBMqGA
Find Users for an Ad Account	GET	/rest/adAccountUsers	conn_mod_def::GKRUO3_gwo8::IBULmbOdSFajkV7tvT6XLA
Get an Ad Account User	GET	/rest/adAccountUsers/(account={{account}},user={{user}})	conn_mod_def::GKRUOunNIdE::cbYhSLLNTNyqccAWUgCXzQ
List the Authenticated User’s LinkedIn Ads Account Access Levels	GET	/rest/adAccountUsers	conn_mod_def::GKRUXLvGVEw::7NV_kukwQR2V7x9P7_5I9w
Create an Ad Account User	PUT	/rest/adAccountUsers/(account:{{sponsoredAccountURN}},user:{{personURN}})	conn_mod_def::GKRUOletCHw::xrL17G0uQ-mFnz3zIXtsmQ
Delete an Ad Account User	DELETE	/rest/adAccountUsers/(account={{account}},user={{user}})	conn_mod_def::GKRUOkQ5CM8::qChZkj3zRd270zyps4HUKg
Grant User Access to an Ad Account	PUT	/rest/adAccountUsers/(account={{account}},user={{user}})	conn_mod_def::GKRUPA5WiAI::qlfultxcT0eYGer-bMKlbA
Remove User Access From an Ad Account	DELETE	/rest/adAccountUsers/(account={{account}},user={{user}})	conn_mod_def::GKRUPB0wP5k::L6LlipSVRomIp2cT6Y-8kw
Update an Existing Ad Account User	POST	/rest/adAccountUsers/(account={{account}},user={{user}})

SocialActions

Action	Method	Path	Action id
Batch Get Summary of Social Actions	GET	/rest/socialActions	conn_mod_def::GKRUZX0bqq0::DzQfiHGqSZK_CfJzGVfpmQ
Get a Comment on a Social Action	GET	/rest/socialActions/{{shareUrnUgcPostUrnCommentUrn}}/comments/{{commentId}}	conn_mod_def::GKRUZ1KS3o4::jvRt7jLcQc2Z84tC8EBKow
Retrieve a Summary of Social Actions for a Share, UGC Post, or Comment	GET	/rest/socialActions/{{shareUrn|ugcPostUrn|commentUrn}}	conn_mod_def::GKRUaDZZuw4::GuOpPtLBRte7vX66N3GDeQ
Retrieve Likes on a Social Action	GET	/rest/socialActions/{{shareUrnUgcPostUrnCommentUrn}}/likes	conn_mod_def::GKRUahoXPxs::gDutPJGPSzOX_4lsBHEN_w
Create a Comment on a Share, UGC Post, or Comment	POST	/rest/socialActions/{{shareUrnUgcPostUrnCommentUrn}}/comments	conn_mod_def::GKRUbqXHHCQ::OYYZ1WUYSzS6M1HY6sfzXw
Create a Comment on a Social Action	POST	/rest/socialActions/{{shareUrnUgcPostUrnCommentUrn}}/comments	conn_mod_def::GKRUZrTNxH8::bv3XMw8vTTKWVXYrirhR8w
Create a Like on a Share, UGC Post, or Comment	POST	/rest/socialActions/{{shareUrn|ugcPostUrn|commentUrn}}/likes	conn_mod_def::GKRUZrjn2Ik::bSubQkcNRv-OwABTkT6TIg
Delete a Like on a Social Action	DELETE	/rest/socialActions/{{socialActionUrn}}/likes/{{actor}}	conn_mod_def::GKRUZ1AcJY4::Q0jzWZt5TiyNOwhjHB9d5w
Edit a Comment on a Social Action	POST	/rest/socialActions/{{shareUrnOrUgcPostUrn}}/comments/{{commentId}}	conn_mod_def::GKRUbqhUGzk::PnXQ_0BsTn-Fgj9i5RHkPQ

Assets

Action	Method	Path	Action id
Check Live Event Recipe Status	GET	/v2/assets/{{id}}	conn_mod_def::GKRUNgiyP1U::NIaFt6_xS6C0-7mPpSjNQQ
Check Status of an Asset Upload	GET	/rest/assets/{{assetId}}	conn_mod_def::GKRUVznb2qM::E8SCHFeGS-OGdQYgLGNxgQ
Get Media Artifacts for an Asset	GET	/rest/assets/{{assetId}}	conn_mod_def::GKRUWYhBmGs::Rv2gjOxJT0WvxUfM9k1f2A
Complete a Multi-Part Asset Upload	POST	/rest/assets	conn_mod_def::GKRUV1lBdC4::V-ZwZQMXRwqyDHiVvbnD2g
Register a Multi-Part Asset Upload	POST	/rest/assets	conn_mod_def::GKRUXCSGT8w::q2bdmmU-SxmOUPTcPwM9SQ
Register a Video Upload Asset	POST	/rest/assets	conn_mod_def::GKRUWxmVGBg::mS9KfDFeQGOzkbCmfN4iXg
Register an Image or Video Upload	POST	/v2/assets	conn_mod_def::GKRUNG-b79E::gIoaOu9bQxaODDj1TTAVKA
Register an Image Upload	POST	/rest/assets	conn_mod_def::GKRUWxmY0Ec::ZhYtOFPOS1KLAKYI47b2Lw

UgcPosts

Action	Method	Path	Action id
Retrieve UGC Posts	GET	/v2/ugcPosts/{{encodedUgcPostUrnOrShareUrn}}	conn_mod_def::GKRUM811fxI::UsjbtlPbTjeEz4yRWnYy4Q
Create a Group UGC Post	POST	/v2/ugcPosts	conn_mod_def::GKRUMu0VHdY::WeDgVRjrSyeO-N7T5LgJIA
Create a LinkedIn Share Post	POST	/v2/ugcPosts	conn_mod_def::GKRUNHOSId0::9SKsD7MBSHKFKk8iH2z0dQ
Create a LinkedIn UGC Post	POST	/v2/ugcPosts	conn_mod_def::GKRUNwzQCEo::xNrVspp-SHORRzv9gleOcw
Create an Announcement UGC Post	POST	/v2/ugcPosts	conn_mod_def::GKRUNWAjzj4::tkikDebrS3ibshFbIyZ-YA
Create an Organic Targeted Company UGC Post	POST	/rest/ugcPosts	conn_mod_def::GKRUb2gnnv0::CIqlnLQKRy6gKlgGdkFMOA
Create UGC Posts	POST	/v2/ugcPosts	conn_mod_def::GKRUMv3YUF0::HvE7ltd-R-aaJpw921ydGA
Delete a UGC Post	DELETE	/v2/ugcPosts/{{encodedUgcPostUrnOrShareUrn}}	conn_mod_def::GKRUMuqR_S4::C1MB-qitSMuQn68tSRNMuQ

AdAccounts

Action	Method	Path	Action id
Fetch an Ad Account	GET	/rest/adAccounts/{{adAccountID}}	conn_mod_def::GKRUOvSkI7U::JW-0A5APTte2nZ5oCQl_vQ
Get an Ad Account with Additional Info Fields	GET	/rest/adAccounts/{{adAccountId}}	conn_mod_def::GKRUXNlRsPg::q2ERYepwQ_-hAMWbcO2XDg
Search Ad Accounts	GET	/rest/adAccounts	conn_mod_def::GKRUPC04guk::v-EZkz9yTzOmXXt5CRgAQQ
Batch Create Ad Accounts	POST	/rest/adAccounts	conn_mod_def::GKRUOY1bb7g::x0uxugUnTimtjhAPcbvWhA
Create a Test Ad Account	POST	/rest/adAccounts	conn_mod_def::GKRUOjc7Kk0::LsFW-ME_Qi-SuNfDWAUh-A
Create Ad Account	POST	/rest/adAccounts	conn_mod_def::GKRUOYhPRew::g0law-asSJWfaAXCeUBxTQ

2 more AdAccounts actions are available through search.

This lists 90 of 427 actions. For anything not here, call search_one_platform_actions with platform linked-in. The full catalog is at https://www.withone.ai/knowledge/linked-in.

When a call fails

The error comes from LinkedIn, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/linked-in

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.