LinkedIn Ads tools

LinkedIn ad accounts the connected user can access (id, name, currency, status, serving status, company page reference). Agencies: pick account_id for the other tools. Read only; returns connected=false when no account is linked.

This tool takes no parameters.

Campaign groups of a LinkedIn ad account with status, serving statuses, objective, total/daily budget and schedule. Read only.

LinkedIn campaigns with status, objective, type, daily/total budget, bid, currency, campaign group and targeting. Returns urn and ledger_campaign_id to use with the update tools. Read only.

Creatives (ads) of LinkedIn campaigns: intended status, serving state and hold reasons, review status, referenced post or text-ad fields. Read only.

LinkedIn ad analytics for a date range: spend, impressions, clicks, CTR, CPC, CPM, lead-form opens, leads, website conversions, conversion value, cost per lead (CPL) and cost per conversion per campaign / campaign group / creative / account, plus totals and the rows with 500+ impressions and zero conversions. Real numbers only; never invented.

LinkedIn professional demographics of who saw, clicked and converted on your ads: job title, seniority, job function, industry, company size and country (adAnalytics MEMBER_* pivots) with impressions, clicks, CTR, spend, leads, CPL and website conversions; URNs are resolved to readable names. Each dimension reports the share hidden by LinkedIn's privacy threshold (values with fewer than 3 events are dropped) instead of inventing rows. Read only.

Resolve plain-language targeting (titles, companies, industries, company sizes, locations, seniorities, functions, skills) to LinkedIn targeting facets and return targetingCriteria plus the estimated audience size. Drops facet combinations LinkedIn rejects and says so. Read only; pass targeting_criteria to create_linkedin_campaign or update_linkedin_campaign_targeting.

Latest company page posts (urn, text, content type, published time, sponsored flag) to pick one for create_linkedin_sponsored_content. Needs the r_organization_social scope; otherwise returns a note. Read only.

Search LinkedIn targeting entities by name inside one facet (adTargetingEntities typeahead / facet list) and return their URNs and names. Read only.

Estimate how many LinkedIn members a targeting reaches (audienceCounts): total and active members, with warnings below the 300-member minimum or without a location. Accepts targeting_criteria, facet URN lists or a campaign's saved targeting. Read only.

LinkedIn's suggested bid, bid floor/ceiling and daily budget limits for an audience (adBudgetPricing criteriaV2), in the ad account currency. Read only.

Matched audiences (ad segments) of a LinkedIn ad account (adSegments): list uploads, website retargeting, marketing automation and predictive audiences with status and approximate member count. Use the urn in targeting (include_audience_urns). Read only.

Conversion tracking rules of a LinkedIn ad account (conversions q=account): id, name, type, enabled, attribution windows, value and attached campaigns. Read only.

Lead Gen Forms owned by a LinkedIn ad account (leadForms q=owner): id, name, state, version and question count. Read only.

Leads submitted through LinkedIn Lead Gen Forms (leadFormResponses): submitted time, campaign, creative, every answer and consent. Personal data: use within the form's consent. Read only.

Read the actual copy of LinkedIn ads: text ad headline/description/landing page, or the sponsored post's text, article headline, landing page and call to action. Read only; combine with linkedin_performance_report to compare messages.

Create a LinkedIn campaign group (paused by default). Created on LinkedIn directly when the user asks (the result shows the preview); only with a connected account.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a LinkedIn campaign (sponsored content or text ad) with budget, objective, bidding and targeting from build_linkedin_audience. Writes a draft to the ledger and creates it on LinkedIn (paused by default) directly when the user asks; the result shows the preview. Add creatives with create_linkedin_sponsored_content / create_linkedin_text_ad.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Change a LinkedIn campaign's daily budget, total budget and/or bid. Applied directly when the user asks; the result shows the current → new values and the +50% per change guardrail applies.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Pause, resume (ACTIVE) or archive a LinkedIn campaign. Applied directly when the user asks.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Activate, pause, archive, draft or delete (PENDING_DELETION) a LinkedIn campaign group. Applied directly when the user asks.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Update a LinkedIn campaign group's total budget, daily budget, end date or name. Applied directly when the user asks.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Replace a LinkedIn campaign's targeting, either with targeting_criteria from build_linkedin_audience or with facet URN lists (geo, job title, function, seniority, industry, skill, company size, employer, matched audiences, plus exclusions and interface language). Applied directly when the user asks.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Turn an existing company page post into sponsored content (a creative) in a LinkedIn campaign, or create a new dark post as the creative. Applied directly when the user asks; LinkedIn reviews the creative before it serves.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a LinkedIn text ad creative (headline ≤25, description ≤75 chars, landing page) in a TEXT_AD campaign. Applied directly when the user asks.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Pause, activate, archive or draft one or more LinkedIn creatives (e.g. the ones with impressions but no conversions). Applied directly when the user asks; creatives under review cannot be paused.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Attach a conversion tracking rule to a LinkedIn campaign (campaignConversions PUT) so it reports and optimises for it. Applied directly when the user asks.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Detach a conversion tracking rule from a LinkedIn campaign (campaignConversions DELETE). Applied directly when the user asks.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Delete a LinkedIn campaign: a DRAFT campaign is deleted permanently, any other is set to PENDING_DELETION (reporting data stays). Irreversible; only call it when the user explicitly asked for it.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Delete a LinkedIn campaign group: permanent when DRAFT, otherwise marked PENDING_DELETION. Irreversible; only call it when the user explicitly asked for it.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Delete a LinkedIn creative (ad): permanent when DRAFT, otherwise marked PENDING_DELETION. Irreversible; only call it when the user explicitly asked for it.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Update a LinkedIn campaign in one call: name, optimisation target, cost type and schedule in one action; budget/bid and status are opened as their own guarded actions (same rules as update_linkedin_campaign_budget / _status). Each is applied and undone separately.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Update a LinkedIn campaign group (only the given fields): name, status, total budget, objective, start and end date. Applied directly when the user asks; budget increases above +50% are refused.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a new LinkedIn ad account for the connected user (the one with no ad account after OAuth). Only call it when the user explicitly asked for it; the account is created at once, the user becomes its ACCOUNT_MANAGER and the connection is linked to it. Currency is permanent; a payment method must still be added in Campaign Manager.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.