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_creative with the campaign_id
• To add MORE campaigns (different audience): use add_linkedin_campaign_to_group with 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)

POST /api/v1/tools/create_linkedin_carousel_campaign/execute

Create LinkedIn Carousel Campaign

cURL

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/create_linkedin_carousel_campaign/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "call_to_action": "LEARN_MORE",
    "campaign_group_id": "string",
    "campaign_group_name": "string",
    "campaign_name": "string",
    "cards": [
      {
        "headline": "string",
        "image_url": "string",
        "image_urn": "string",
        "landing_page_url": "https://example.com"
      }
    ],
    "daily_budget": 10,
    "industries": [
      "string"
    ],
    "introductory_text": "string",
    "landing_page_url": "https://example.com",
    "locations": [
      "string"
    ],
    "objective": "WEBSITE_VISIT",
    "organization_id": "string",
    "seniorities": [
      "string"
    ]
  }
}
'

200

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for create_linkedin_carousel_campaign)"
  },
  "success": true,
  "tool": "create_linkedin_carousel_campaign"
}

Authorizations

Authorization · string · header · required

API key from https://adspirer.ai/keys. Prefix sk_live_. Treat as a secret — never commit.

Headers

Idempotency-Key · string<uuid>

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

application/json

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.

arguments · object · required

Input schema for creating LinkedIn Carousel Ad campaigns

Show child attributes

Response

200

application/json

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.

data · object · required

Show child attributes

success · boolean · required

tool · string · required

Echoed tool_name from the request URL.