API Reference › TikTok Ads › create_tiktok_carousel_card

create_tiktok_carousel_card

TikTok Ads Write

Create a carousel card from multiple images for TikTok carousel ads

Endpoint

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

Headers

Description

Create a carousel card from multiple images for TikTok carousel ads. IMPORTANT: Call this tool BEFORE creating a carousel campaign or carousel ad. Carousel ads show 2-10 swipeable image cards. Each card can have its own ad text and landing page. Workflow for carousel campaigns: 1. Get TikTok image IDs: - Option A: upload_tiktok_images with public image URLs (uploads to TikTok, returns image_ids) - Option B: discover_tiktok_assets to find existing images in your library 2. Call this tool with those image_ids to create a carousel card (get card_id back) 3. Use the card_id in create_tiktok_campaign or add_tiktok_ad with card_type='IMAGE' Required: image_ids (2-10 TikTok image IDs). Optional: ad_texts (one per card), landing_page_urls (one per card), call_to_action.

Request body

All tool arguments are wrapped in an arguments object.

FieldTypeDescription
image_idsarray requiredList of TikTok image IDs (2-10). Get image IDs from discover_tiktok_assets (existing library images) or from a previously created image campaign's assets.
card_typestring optionalCard type: 'IMAGE' (image carousel) or 'PRODUCT' (product catalog). Default: IMAGE. default: "IMAGE"
ad_textsarray optionalAd text for each card (one per image). If fewer texts than images, the first text is reused.
landing_page_urlsarray optionalLanding page URL for each card (one per image, must be HTTPS). If fewer URLs than images, the first URL is reused.
call_to_actionstring optionalCTA button for all cards: LEARN_MORE, SHOP_NOW, SIGN_UP, etc.
advertiser_idstring optionalTikTok advertiser ID (optional).

Example request

{
  "arguments": {
    "image_ids": [
      "string"
    ],
    "card_type": "IMAGE",
    "ad_texts": [
      "string"
    ],
    "landing_page_urls": [
      "string"
    ],
    "call_to_action": "string",
    "advertiser_id": "string"
  }
}

Example responses

200 — Success

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

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": "create_tiktok_carousel_card"
}

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": "create_tiktok_carousel_card",
  "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: TikTok Ads · All tools

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