MMetadata /docs
⌘K
Docs/Tools/create_update_carousel_ad

create_update_carousel_ad

Create OR update a CAROUSEL ad on Reddit (Reddit only).

Destructive creative

Deletes, archives, launches or moves budget. Do not give an agent this one without a human gate.

What it does

Create OR update a CAROUSEL ad on Reddit (Reddit only).
                                TO UPDATE: include `id`; to CREATE: omit it.

                                A carousel is a SINGLE ad with 2 to 6 swipeable cards. Each card is an
                                image with its own optional CTA; the headline is shared across the whole ad.

                                CREATIVE WORKFLOW:
                                  1. Upload each card image via `upload_image_creative` -> response gives `id` (the imageLibraryId).
                                  2. Pass those ids as cards[].imageLibraryId here (2 to 6 cards, no duplicate images).
                                  3. Optionally upload a separate thumbnail image and pass its id as thumbnailLibraryId.

                                ALSO KNOWN AS: create carousel ad, update carousel ad, edit carousel ad,
                                modify carousel ad, multi-image ad, swipeable ad, Reddit carousel.

                                CLIENT-SIDE VALIDATION (mirrors what the platform UI rejects):
                                  - adName: required, max 50 chars.
                                  - headline: required, max 300 (shared across all cards).
                                  - cards: 2 to 6 items; each needs imageLibraryId; no duplicate images.
                                  - cards[].cta: optional, must be a valid Reddit CTA enum.
                                  - text: optional body, max 2000.
                                  - thumbnailLibraryId: optional.

                                REDDIT CTA VALUES: Apply Now, Contact Us, Download, Get a Quote, Learn More,
                                Play Now, Sign Up, View More, Watch Now, Book Now, Listen Now, Read More, Subscribe.

                                See `create_update_image_ad` / `create_update_video_ad` for single-creative Reddit ads.

Arguments

ArgumentTypeNotes
adName string required Ad name. Required, max 50 chars.
headline string required Headline shared across all cards. Required, max 300.
cards array required 2 to 6 carousel cards. Each card needs a distinct image (no duplicates).
text string Optional body text. Max 2000.
thumbnailLibraryId integer Optional thumbnail image library id.
completionStatus string DRAFT (default) persists locally without publishing; COMPLETED finalizes the ad.
one of: DRAFT, COMPLETED
id integer Include to UPDATE an existing carousel ad; omit to CREATE.

Request

curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
  -H "Authorization: $METADATA_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"create_update_carousel_ad","arguments":{"adName":"<adName>","headline":"<headline>","cards":[]}}}'

Response

No recorded response. This tool can delete, archive, launch or move budget, so it is never executed to build these docs. The request above is still the exact shape to send. Nothing on this page is invented.

Other creative tools:

All 160 tools · machine-readable index