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.

Create a LinkedIn campaign group (paused by default). Returns a preview and opens an approval item; created on LinkedIn only after approval and 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 opens an approval item with a preview; created on LinkedIn (paused by default) after approval. 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. Returns a preview with the current → new values; applied after approval (budget decreases and small increases may auto-apply per the user's approval policy).

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. Goes through preview and the approval policy.

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. Always previewed and approved first.

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. Previewed and approved first.

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

Replace a LinkedIn campaign's targeting with targeting_criteria from build_linkedin_audience. Previewed and approved first.

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. Previewed and approved first; 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. Previewed and approved first.

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). Previewed and approved first; creatives under review cannot be paused.

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