Documentation / Tool Reference

LinkedIn Ads tools

Tools for the LinkedIn Marketing API: campaign groups & campaigns, text and sponsored content ads, professional targeting, and analytics.

Connection & Account · 2

connect_linkedin_adsfree

Generates a one-time authorization link to connect a LinkedIn ad account.

list_linkedin_ad_accounts1 credits

Lists the user's connected LinkedIn ad account(s).

all_accessible

Reading & Analytics · 5

linkedin_campaign_analytics2 credits

LinkedIn performance report.

account_iddayspivottime_granularityfieldsinclude_ad_previews
linkedin_targeting_search1 credits

Searches LinkedIn targeting entities by name → returns the URNs you pass to create_linkedin_campaign / update_linkedin_campaign_targeting.

queryfacet
list_linkedin_campaign_groups1 credits

Lists ALL campaign groups in a LinkedIn ad account (fully paginated).

account_id
list_linkedin_campaigns1 credits

Lists ALL API-level campaigns in a LinkedIn ad account (fully paginated).

account_id
list_linkedin_creatives1 credits

Lists ALL creatives (ads) in a LinkedIn account (fully paginated); if campaign_id is given, limits to that campaign.

account_idcampaign_idinclude_previews

Campaign group · 3

create_linkedin_campaign_group5 credits

Creates a LinkedIn campaign group — a 'Campaign' in the Campaign Manager UI.

account_idnamestatustotal_budgetobjective_typeconfirm
delete_linkedin_campaign_group5 credits

Deletes a LinkedIn campaign group (permanent if DRAFT; otherwise marked for deletion).

account_idgroup_idconfirm
update_linkedin_campaign_group5 credits

Updates a LinkedIn campaign group (only the provided fields change).

account_idgroup_idnamestatustotal_budgetconfirm

Campaign · 4

create_linkedin_campaign8 credits

Creates a LinkedIn campaign.

account_idcampaign_group_idnamecampaign_typecost_typeunit_costdaily_budgettotal_budgetcountrylanguagegeo_urnsobjective_typestatusassociated_entity
delete_linkedin_campaign5 credits

Deletes a LinkedIn campaign (permanent if DRAFT; otherwise marked for deletion; reporting data is preserved).

account_idcampaign_idconfirm
update_linkedin_campaign5 credits

Updates a LinkedIn campaign (only the fields provided).

account_idcampaign_idnamestatusdaily_budgetunit_costoptimization_targetcost_typeconfirm
update_linkedin_campaign_targeting5 credits

Updates a LinkedIn campaign's targeting (job title, function, seniority, industry, skill, company size, geography).

account_idcampaign_idgeo_urnslocation_modeaudience_languageexclude_geo_urnsexclude_industry_urnsexclude_employer_urnsexclude_title_urnsexclude_function_urnsexclude_seniority_urnsexclude_skill_urnsexclude_staff_count_urnsjob_title_urns

Ad & Creative · 4

create_linkedin_post_ad8 credits

Turns an existing Company Page post into an ad (Sponsored Content) for a SPONSORED_UPDATES campaign.

account_idcampaign_idpost_urnintended_statusconfirm
create_linkedin_text_ad8 credits

Creates a text ad (creative) for a TEXT_AD campaign — does not require an organization page.

account_idcampaign_idheadlinedescriptionlanding_pageintended_statusconfirm
delete_linkedin_creative5 credits

Deletes a creative (ad) — permanent if DRAFT, otherwise marked for deletion.

account_idcreative_idconfirm
update_linkedin_creative_status5 credits

Changes a creative's (ad's) intended status: ACTIVE | PAUSED | DRAFT | ARCHIVED.

account_idcreative_idintended_statusconfirm

Other

attach_linkedin_conversionfree

Attaches an existing conversion tracking rule to a LinkedIn campaign so it reports/optimizes for that conversion.

account_idcampaign_idconversion_idconfirm
detach_linkedin_conversionfree

Removes a conversion tracking rule from a LinkedIn campaign (ad set) — the inverse of attach_linkedin_conversion.

account_idcampaign_idconversion_idconfirm
download_linkedin_leads2 credits

Downloads the leads submitted through LinkedIn Lead Gen Forms (name, email, phone and every other answer), so they can be worked or exported.

account_idform_idsinceuntiltest_onlylimit
linkedin_ad_copy1 credits

Reads the actual AD COPY of specific LinkedIn ads — built for "which messaging performs best" analysis.

account_idcreative_idspost_urns
linkedin_audience_forecastfree

Asks LinkedIn HOW MANY MEMBERS a targeting setup reaches — the pre-flight check to run BEFORE create_linkedin_campaign / update_linkedin_campaign_targeting.

account_idcampaign_idgeo_urnscountryaudience_languagejob_title_urnsjob_function_urnsseniority_urnsindustry_urnsskill_urnsstaff_count_urnsinclude_audience_urnsexclude_audience_urnsexclude_geo_urns
linkedin_bid_recommendationsfree

Asks LinkedIn what it actually costs to advertise to a given audience — the SUGGESTED BID and the allowed bid floor/ceiling in the account's own currency, plus the minimum daily budget.

account_idcampaign_typeobjective_typebid_typegeo_urnscountrylanguage
list_linkedin_audiencesfree

Lists a LinkedIn account's MATCHED AUDIENCES (Dreamdata/CRM company lists, website retargeting, video/document/lead-form engagement, contact lists, predictive) — fully paginated.

account_id
list_linkedin_conversionsfree

Lists ALL conversion tracking rules on a LinkedIn ad account — fully paginated.

account_id
list_linkedin_lead_forms1 credits

Lists the LinkedIn Lead Gen Forms of an ad account — id, name, status and question count.

account_id