> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Carousel Ad

> Create a LinkedIn carousel ad (sponsored creative) under an ad set, with 2-10 image cards (each card has its own image, headline, and destination URL)

Create a LinkedIn carousel ad (sponsored creative) under an ad set, with 2-10 image cards (each card has its own image, headline, and destination URL). Uploads card images and creates the creative inline. Supports lead-gen forms.

|                       |                                   |
| --------------------- | --------------------------------- |
| **App**               | LinkedIn Ads                      |
| **Operation ID**      | `linkedin_ads_create_carousel_ad` |
| **Type**              | Action                            |
| **Connection**        | `linkedin_ads` (required)         |
| **Credits per run**   | 2                                 |
| **Agent / MCP tool**  | Yes                               |
| **Requires approval** | Yes (write operation)             |

## Inputs

| Field             | Type                          | Required | Default                                | Description                                                                                                        |
| ----------------- | ----------------------------- | -------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `account`         | DynamicAccount                | Yes      | -                                      | LinkedIn Ads account to create the ad in.                                                                          |
| `adset_id`        | string or SelectItem          | Yes      | -                                      | Ad set (LinkedIn sponsored campaign) the ad belongs to.                                                            |
| `organization`    | string or SelectItem          | Yes      | -                                      | Company Page used as the post author. Accepts an organization id or urn:li:organization:123.                       |
| `cards`           | array of LinkedInCarouselCard | Yes      | -                                      | The carousel cards (2-10). Each has an image, a headline, and an optional destination URL override.                |
| `intro_text`      | string                        | No       | -                                      | Introductory text shown above the carousel. Up to 255 characters.                                                  |
| `destination_url` | string                        | Yes      | -                                      | Primary landing page URL for the carousel ad. Cards use this URL unless they provide their own destination\_url.   |
| `ad_name`         | string                        | No       | -                                      | Optional creative name. Up to 255 characters.                                                                      |
| `lead_form`       | string or SelectItem          | No       | -                                      | Optional LinkedIn lead-gen form. Provide this for Lead Generation ad sets. Accepts a form id or urn:li:adForm:123. |
| `call_to_action`  | string or SelectableOption    | No       | -                                      | Call-to-action label, used when a lead form is attached.                                                           |
| `status`          | string or SelectableOption    | No       | `{'value': 'DRAFT', 'label': 'Draft'}` | Initial creative status: DRAFT (safely inactive) or ACTIVE (submitted for review).                                 |

### LinkedInCarouselCard

A single carousel card: an image, a headline, and optional URL override.

| Field             | Type   | Required | Default | Description                                                                  |
| ----------------- | ------ | -------- | ------- | ---------------------------------------------------------------------------- |
| `image_url`       | string | Yes      | -       | Card image URL or a Google Drive share link.                                 |
| `headline`        | string | Yes      | -       | Card headline shown on the card. Up to 255 characters.                       |
| `destination_url` | string | No       | -       | Optional card-specific landing page URL. Defaults to the ad destination URL. |

### SelectItem

| Field   | Type   | Required | Default | Description                                                                                          |
| ------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------- |
| `value` | string | Yes      | -       | The value of the selectable item.                                                                    |
| `label` | string | Yes      | -       | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |

### SelectableOption

| Field   | Type   | Required | Default | Description |
| ------- | ------ | -------- | ------- | ----------- |
| `value` | string | Yes      | -       |             |
| `label` | string | Yes      | -       |             |

## Output

**Type**: `Dict`

Returns the created LinkedIn carousel ad creative ID.

**Fields**: `creative_ids`, `created_count`, `card_count`