Create LinkedIn Carousel Campaign
USE THIS TOOL WHEN: User wants to create a LinkedIn CAROUSEL ad campaign (2-10 swipeable image cards).
DO NOT USE for image ads → use create_linkedin_image_campaign instead.
DO NOT USE for video ads → use create_linkedin_video_campaign instead.
DO NOT USE for text ads → use create_linkedin_text_campaign instead.
REQUIRED: Either campaign_group_name (creates new group) or campaign_group_id (adds to existing group).
IMPORTANT: This creates the campaign with 1 creative (Variation 1). Campaign is created in PAUSED status.
Carousel Specifications:
- 2-10 cards required (3-5 is the sweet spot)
- All images must be 1080x1080 (1:1 aspect ratio)
- Each card has: image, headline (max 45 chars), landing page URL
- Introductory text max: 255 characters
Required Parameters:
- campaign_name, daily_budget, organization_id
- introductory_text (up to 255 chars), landing_page_url (overall)
- cards: Array of 2-10 cards, each with image (urn or url), headline, landing_page_url
- locations (targeting)
- campaign_group_name OR campaign_group_id
Default Objective: WEBSITE_VISIT
AD POLICY: NEVER use “LinkedIn” in ad copy. NEVER mention competitor platforms.
After Creation — IMPORTANT:
- This tool created 1 campaign + 1 creative. Campaign Group ID is returned.
- To add MORE carousel creatives (A/B test text): use
add_linkedin_carousel_creativewith the campaign_id - To add MORE campaigns (different audience): use
add_linkedin_campaign_to_groupwith the campaign_group_id - NEVER call this create tool again without campaign_group_id — that creates a SEPARATE campaign group
Execution time: 15-60 seconds (includes image uploads)
Authorizations
API key from https://adspirer.ai/keys. Prefix sk_live_. Treat as a secret — never commit.
Headers
Client-generated UUID to make writes idempotent. Strongly recommended for write tools. A repeat call with the same key returns the cached result instead of re-executing. Example: 550e8400-e29b-41d4-a716-446655440000
Body
All tool arguments are wrapped in an arguments object. The fields accepted inside arguments are listed below — required fields are marked with a red asterisk.
Input schema for creating LinkedIn Carousel Ad campaigns
Response
Tool executed successfully. data.text carries the human-readable result (markdown-friendly). data.quota shows your current usage against the plan limit. data.structured appears when the tool emits machine-parseable structured content. data.content appears for tools that return non-text blocks (images, resources).
Returned on HTTP 200. data.text is the primary human-readable output. data.quota is always present for billable calls. data.structured is set only when the tool emits machine-parseable structured content. data.content is set only when the tool emits non-text content blocks.