---
title: "create_update_carousel_ad. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/create_update_carousel_ad
description: "Create OR update a CAROUSEL ad on Reddit (Reddit only). Destructive tool on the Metadata MCP server, with its full JSON Schema."
source: metadata.io
---

# create_update_carousel_ad

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

Destructive [creative](https://metadata.io/developers/tools/#cat-creative)

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `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

**Request template, not a complete runnable example.** Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

## Response

## Related

Other creative tools:

- [archive_ad](https://metadata.io/developers/tools/archive_ad) Destructive
- [create_update_convo_ad](https://metadata.io/developers/tools/create_update_convo_ad) Destructive
- [create_update_document_ad](https://metadata.io/developers/tools/create_update_document_ad) Destructive
- [create_update_google_ads_ad](https://metadata.io/developers/tools/create_update_google_ads_ad) Destructive
- [create_update_image_ad](https://metadata.io/developers/tools/create_update_image_ad) Destructive
- [create_update_linkedin_message_ad](https://metadata.io/developers/tools/create_update_linkedin_message_ad) Destructive
- [create_update_microsoft_ads_ad](https://metadata.io/developers/tools/create_update_microsoft_ads_ad) Destructive
- [create_update_video_ad](https://metadata.io/developers/tools/create_update_video_ad) Destructive

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)