API Reference › LinkedIn Ads › select_linkedin_campaign_type

select_linkedin_campaign_type

LinkedIn Ads Read

User wants to create a LinkedIn ad campaign but hasn't specified the campaign type (image, video, carousel, or text)

Endpoint

POST https://api.adspirer.ai/api/v1/tools/select_linkedin_campaign_type/execute

Headers

Description

User wants to create a LinkedIn ad campaign but hasn't specified the campaign type (image, video, carousel, or text). IMPORTANT: This tool should be called BEFORE any asset discovery or campaign creation when the user says things like: - "Create a LinkedIn campaign" - "Run LinkedIn ads" - "I want to advertise on LinkedIn" - "Set up a LinkedIn advertising campaign" - "Help me create ads on LinkedIn" This tool asks the user what TYPE of campaign they want to create, then provides guidance on the next steps including creative quantity best practices. Campaign Types Available: 1. image — Single image ad in the feed (most common, 4-5 ad variations recommended) 2. video — Video ad in the feed (good for demos, storytelling, 3-4 variations recommended) 3. carousel — 2-10 swipeable image cards (good for multi-product showcase, 3-5 cards recommended) 4. text — Simple desktop right-rail/top-banner ad (budget-friendly, 3-4 variations recommended) Returns: - Confirmation of selected campaign type - Specific requirements and creative specs for that type - Recommended number of ad variations per LinkedIn best practices - Next steps and which tool to use Do NOT use this tool if: - User specifically asks for "image campaign" / "single image" - go directly to image workflow - User specifically asks for "video campaign" / "video ad" - go directly to video workflow - User specifically asks for "carousel" / "multiple images" - go directly to carousel workflow - User specifically asks for "text ad" / "simple ad" - go directly to text workflow - User is asking about performance/analytics - use performance analysis tools Parameters: - campaign_type: 'image', 'video', 'carousel', or 'text' Execution time: Instant (no API call)

Request body

All tool arguments are wrapped in an arguments object.

FieldTypeDescription
campaign_typestring requiredType of LinkedIn campaign to create. Options: 'image' (single image ad), 'video' (video ad), 'carousel' (2-10 swipeable cards), 'text' (desktop text ad)

Example request

{
  "arguments": {
    "campaign_type": "string"
  }
}

Example responses

200 — Success

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

400 — Tool-level error (bad arguments / multi-account selection)

{
  "success": false,
  "error": "You have 25 meta_ads accounts connected. Please specify which account to use by passing the ad_account_id parameter:\n  - Acme Holdings (ad_account_id=\"act_123456789\")\n  - Acme EU (ad_account_id=\"act_987654321\")",
  "is_error": true,
  "tool": "select_linkedin_campaign_type"
}

402 — Quota exhausted

{
  "success": false,
  "error": "\ud83d\udea8 Monthly limit reached (150/150 tool calls on Plus tier).\nUpgrade to Pro at https://adspirer.ai to keep building.",
  "is_error": true,
  "tool": "select_linkedin_campaign_type",
  "quota": {
    "used": 150,
    "limit": 150,
    "tier": "plus",
    "period_end": "2026-05-01",
    "upgrade_url": "https://adspirer.ai"
  }
}

Try it live

Interactive: Swagger UI

Machine-readable: OpenAPI 3.1 spec · llms-full.txt

More tools: LinkedIn Ads · All tools

Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai