Linkedin Ads
LinkedIn Marketing and Advertising API for managing ad campaigns, analytics, and organization social content
Verdict
Common use cases
- Pull weekly campaign performance during planning calls
- Forecast audience size before launching new targeting
- Create lead forms for gated content campaigns
- Compare creative performance across account groups
- Check daily spend against budget caps
Integration
- Vendor
- Linkedin Ads
- Category
- other
- Auth
- OAUTH2
- Tools
- 28
- Composio slug
linkedin_ads
Tools
- Create Ad Account
Tool to create a new LinkedIn ad account for campaign management. Use when setting up advertising infrastructure for an organization or person. The account type must be BUSINESS (ENTERPRISE is reserved for LinkedIn internal use). The Ad Acc
- Create Lead Form
Tool to create a new LinkedIn lead generation form for ads. Use when you need to create forms to collect leads from LinkedIn ads campaigns.
- Get Ad Account
Tool to retrieve a specific LinkedIn Ad Account by ID. Returns detailed account information including name, status, currency, notification settings, and serving statuses. Use when you need to fetch details about a specific ad account.
- Get Ad Analytics
Tool to retrieve LinkedIn ad analytics and reporting metrics for campaigns, creatives, and accounts. Use when you need performance data such as impressions, clicks, costs, conversions, and engagement metrics. Supports filtering by accounts,
- Get Ad Supply Forecasts
Retrieve supply forecasts for LinkedIn ad inventory based on targeting criteria, budget, and bid settings. Provides forecasts for impressions, clicks, spending, reach, and other metrics with different time granularities (daily, 7-day, 30-da
- Get Audience Counts
Get estimated audience size for given targeting criteria on LinkedIn Ads. Use when you need to forecast how many LinkedIn members match your campaign targeting parameters before creating ads. Minimum audience size of 300 required to run cam
- Get Campaign Group
Tool to retrieve a specific LinkedIn Ads campaign group by ID. Use when you need detailed information about a campaign group including its budget, schedule, status, and serving conditions.
- Get lead form by ID
Tool to retrieve a specific LinkedIn lead form by its ID. Use when you need to fetch details about a lead form including its questions, legal info, and configuration.
- Get organization access control list
Tool to retrieve organization access control list showing who has admin or poster rights for organizations. Use when you need to check which members have specific roles (like ADMINISTRATOR or DIRECT_SPONSORED_CONTENT_POSTER) for an organiza
- Get organization follower count
Tool to retrieve follower count for a LinkedIn organization. Use when you need to get the number of followers for a company or organization page.
- Get organization follower statistics
Tool to retrieve follower growth statistics for a LinkedIn organization. Use when you need follower demographics (industry, seniority, location, function) or time-bound follower gains. Omit timeIntervals for lifetime demographic statistics;
- Get organization page statistics
Tool to retrieve page view and click statistics for a LinkedIn organization page. Use when you need to analyze organization page engagement metrics, either for lifetime or specific time periods.
- Get organization share statistics
Tool to retrieve share and engagement statistics for an organization's content on LinkedIn. Use when you need organic metrics like impressions, clicks, likes, comments, and shares for an organization's posts. Returns lifetime statistics by
- Get Targeting Entities
Tool to retrieve targeting entities for LinkedIn Ads campaigns. Use when you need to discover available targeting options (industries, locations, job titles, companies, skills, etc.) for ad targeting. Supports multiple query modes: retrieve
- Get Targeting Facets
Tool to retrieve available ad targeting facets including industries, locations, seniorities, job functions, skills, and more. Use when you need to discover which targeting categories are available for LinkedIn ad campaigns before fetching s
- List Conversion Rules
Tool to list all conversion rules for a LinkedIn ad account. Use when you need to retrieve conversion tracking rules configured for an ad account.
- List DMP Segments
Tool to list DMP (Data Management Platform) segments for LinkedIn ad accounts. Use to retrieve segments by account, fetch multiple segments by IDs, or search segments with pagination. DMP segments contain audience data for ad targeting.
- List Lead Forms
Tool to list LinkedIn lead forms for an organization or by specific IDs. Use when you need to retrieve lead forms owned by an organization or sponsored account, or fetch specific forms by their IDs.
- List LinkedIn posts
Tool to list LinkedIn posts by author or retrieve multiple posts by IDs. Use when you need to fetch posts for a specific person/organization or retrieve specific posts by their URNs.
- List Organizations
Tool to search and list LinkedIn organizations by IDs, vanity name, or parent organization. Use when you need to retrieve organization information, company pages, or school profiles from LinkedIn. Supports batch lookup by IDs or search by v
- Lookup organizations
Tool to batch lookup organization details by IDs without requiring admin access. Use when you need to retrieve basic information about LinkedIn organizations like name, logo, locations, and website.
- Register Upload
Tool to register an upload for media assets (images, videos) on LinkedIn. Use when you need to prepare for uploading media content to LinkedIn before creating posts or ads.
- Search Ad Accounts
Tool to search for LinkedIn ad accounts with filtering by status, type, and test mode. Use when you need to find ad accounts based on specific criteria like status, type, or whether they are test accounts. Supports pagination for large resu
- Search Campaigns
Tool to search and list campaigns in a LinkedIn Ads account with filtering options. Use when you need to retrieve campaigns with specific criteria such as status, type, or test flag.
- Search Events
Tool to search and list LinkedIn events by organizer with filtering options. Use when you need to find events organized by a specific organization or person, with optional filters for lifecycle state, entry criteria, and pagination.
- Search LinkedIn Ads Creatives
Tool to search and list LinkedIn Ads creatives with filtering options. Use when you need to retrieve creatives from a LinkedIn Ads account with optional filters by campaign, status, content reference, or lead gen form. Supports cursor-based
- Update lead form
Tool to update an existing LinkedIn lead form. Use when you need to modify form details like name, headline, description, or state. Note: For published forms (linked to active campaigns), only specific fields can be updated. Pre-published f
- Update organization access control
Tool to update organization access control for a user on LinkedIn. Use when requesting the DIRECT_SPONSORED_CONTENT_POSTER role for an organization. The PUT API works only when the user is requesting the role for themselves, not on behalf o
Setup
Setup guide
- 11. In Switchy, open your Space settings and click 'Add Integration' under the MCP section. 2. Select 'LinkedIn Ads' from the list and click 'Connect'. 3. You'll redirect to LinkedIn's OAuth consent screen — sign in with an account that has Campaign Manager access. 4. Grant the requested scopes: read ad accounts, read/write campaigns, read analytics, and manage lead forms. 5. LinkedIn redirects you back to Switchy with a success message. 6. Test the connection by opening a Space and typing '@LinkedIn Ads get analytics for campaign [paste a campaign ID]' — if it returns metrics, you're live. 7. To invoke any tool, start your message with '@LinkedIn Ads' followed by the action (create lead form, get audience counts, retrieve forecasts). 8. If you see auth errors, confirm your LinkedIn account has Marketing Developer Platform permissions enabled in Campaign Manager settings.
What teammates see: by default, memories from Linkedin Ads are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Weekly Campaign Review
@LinkedIn Ads get ad analytics for all campaigns in account [account ID] from the last 7 days, grouped by campaign name, showing impressions, clicks, cost, and CTROpen in a Space →
Audience Size Check
@LinkedIn Ads get audience counts for targeting: job titles 'Product Manager' and 'Director of Product', company size 51-200 employees, located in United StatesOpen in a Space →
Lead Form Setup
@LinkedIn Ads create a lead form named 'Q2 Webinar Registration' with questions: email, company name, job title, and a custom question 'What's your biggest product challenge?'Open in a Space →
Forecast Campaign Reach
@LinkedIn Ads get supply forecasts for a campaign targeting software engineers in San Francisco, daily budget $500, CPC bid $8, running for 30 daysOpen in a Space →
Account Status Snapshot
@LinkedIn Ads get ad account details for account ID [account ID], including status, currency, total budget, and any serving restrictionsOpen in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@linkedin-ads what's the estimated audience size for tech professionals in the Bay Area with 5+ years of experience interested in cloud computing?
Based on your targeting criteria, the estimated audience size is approximately 127,000 LinkedIn members. This includes professionals in the San Francisco Bay Area with 5+ years of experience who have indicated interest in cloud computing or related technologies. The forecast suggests this audience could generate 45,000-62,000 impressions per week with a $5,000 budget and moderate bid strategy. Note that actual reach will depend on your creative quality, bid competitiveness, and campaign schedule.
This example demonstrates the Get Audience Counts tool, which helps validate targeting before spending budget. The estimates are directional — actual campaign performance varies by creative quality, seasonality, and competitive bidding. Requires read access to the ad account and valid targeting parameters (job titles, locations, skills, or interests).
@linkedin-ads create a lead form for our Q2 webinar campaign titled 'Cloud Migration Strategies' collecting name, email, company, and job title
Lead form created successfully (ID: urn:li:leadGenForm:123456789). The form is titled 'Cloud Migration Strategies' and includes four fields: full name, business email, company name, and job title. Privacy policy and terms links have been auto-populated from your account settings. The form is now available for attachment to sponsored content campaigns. You can preview it in Campaign Manager or retrieve full configuration details using the form ID.
This showcases the Create Lead Form tool, which provisions lead capture infrastructure for LinkedIn ads. The form is created but not yet attached to any campaign — you'll need to associate it with a sponsored content creative separately. Requires write permissions on the ad account. LinkedIn enforces privacy compliance, so ensure your account has valid legal URLs configured.
@linkedin-ads pull last 30 days of performance data for campaign group 'Q1-Enterprise-Outreach' and identify which creatives had the highest conversion rate
Campaign group 'Q1-Enterprise-Outreach' generated 847,000 impressions, 12,340 clicks (1.46% CTR), and 287 conversions (2.33% conversion rate) over the last 30 days. Total spend: $18,450. Top-performing creative by conversion rate: 'Case Study - Fortune 500 Migration' (3.8% conversion rate, 89 conversions from 2,342 clicks). Second: 'Whitepaper - Security Best Practices' (2.9%, 67 conversions). The video creative 'Customer Testimonial' had high engagement (2.1% CTR) but lower conversion (1.4%), suggesting strong awareness value but weaker intent capture.
This combines Get Ad Analytics with AI synthesis to surface actionable insights from raw metrics. The MCP returns structured performance data; the AI interprets patterns and ranks creatives by your specified goal. Requires analytics read permissions and a valid date range (LinkedIn retains 2 years of data). Attribution windows and conversion tracking must be configured in Campaign Manager for accurate conversion metrics.
Use-case deep-dives
When LinkedIn Ads MCP beats manual form setup
A three-person marketing agency runs LinkedIn lead gen for four SaaS clients. Each client needs custom forms with different qualification questions, and campaigns launch every two weeks. The LinkedIn Ads MCP wins here because the Create Lead Form and Get Lead Form tools let the team template and version-control form configs in Switchy instead of clicking through LinkedIn's UI four times per sprint. The Get Audience Counts tool also speeds up targeting QA before spend starts. The threshold: if you're only running one evergreen campaign, the MCP is overkill—just use LinkedIn's dashboard. But if you're spinning up campaigns weekly and need to audit form questions or forecast reach without tab-switching, this MCP cuts setup time by half.
Why this MCP matters for finance-marketing handoffs
An eight-person startup reviews LinkedIn ad spend monthly with the finance lead and two growth marketers in the same Switchy thread. The Get Ad Analytics tool pulls impressions, clicks, cost-per-lead, and conversion data for all active campaigns without exporting CSVs or screenshotting dashboards. The team can compare campaign groups side-by-side, flag underperforming creatives, and adjust budgets in one conversation. The trade-off: if your finance person already lives in a BI tool that ingests LinkedIn data, this MCP won't replace that workflow. But if your monthly review is currently a Zoom call with three browser tabs open, the MCP turns it into an async thread where everyone sees the same numbers and can ask follow-up questions without waiting for the next meeting.
When 28 tools become a pre-flight system
A distributed five-person demand gen team launches LinkedIn campaigns across three regions. Before this MCP, launch day meant one person checking account status, another forecasting reach, a third verifying lead forms, all in separate tools. Now the team runs a Switchy pre-flight: Get Ad Account confirms serving status and currency settings, Get Audience Counts validates targeting isn't too narrow, Get Ad Supply Forecasts checks if the bid will clear inventory, and Get Lead Form audits form questions for compliance. The whole checklist runs in one thread, and junior team members can execute it without senior oversight. The limit: if you launch fewer than two campaigns per quarter, the setup cost outweighs the benefit. But for teams launching weekly or managing multi-geo rollouts, this MCP turns launch day from a coordination nightmare into a documented, repeatable runbook.
Frequently asked
What can the LinkedIn Ads MCP do in Switchy?
It gives your AI agents full campaign management access — create ad accounts, build lead forms, pull analytics (impressions, clicks, conversions), forecast audience reach, and retrieve campaign group details. All 28 tools mirror LinkedIn's Campaign Manager API, so agents can set up campaigns, optimize budgets, and report performance without switching to the web UI.
Do I need admin access to connect LinkedIn Ads via OAuth?
Yes. The OAuth flow requires Campaign Manager permissions on the LinkedIn ad account you're connecting. If you're not an account admin, the connection will fail or return empty data. Have your ads team lead or account owner complete the setup in Switchy to avoid permission errors.
Can the MCP create and launch campaigns, or just read data?
It can create infrastructure (ad accounts, lead forms) and read analytics, but it doesn't directly launch campaigns or upload creatives. You'll still use Campaign Manager or the API for final creative approval and go-live. Think of this MCP as campaign ops automation — setup, reporting, and forecasting — not a full replacement for the LinkedIn UI.
How does this compare to exporting CSV reports from Campaign Manager?
The MCP pulls live data on demand, so agents can answer "what's our CTR today" without waiting for scheduled exports. You also get audience forecasting and account setup tools that aren't in CSV dumps. Trade-off: no historical trend visualizations — you're working with raw API responses, not dashboards.
Who on the team should connect the LinkedIn Ads account?
Whoever owns your LinkedIn Campaign Manager account and has admin rights. That's usually your paid social lead or growth marketer. Once connected, any Switchy team member can query the MCP (subject to your workspace permissions), but only the original connector can refresh the OAuth token if it expires.