> ## 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 Card

> Creates an X Ads card (website or app, single media or carousel) from raw components matching the X API payload

Creates an X Ads card (website or app, single media or carousel) from raw components matching the X API payload. Pass the returned card\_uri to x\_ads\_create\_post to attach the card.

| | |
| - | - |
| **App** | X Ads |
| **Operation ID** | `x_ads_create_card` |
| **Type** | Action |
| **Connection** | `x_ads` (required) |
| **Credits per run** | 1 |
| **Agent / MCP tool** | Yes |
| **Requires approval** | Yes (write operation) |

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `account` | DynamicAccount | Yes | - | Select the X Ads account to create the card in. |
| `name` | string | Yes | - | Card name, up to 80 characters. |
| `components` | array of object or string | No | - | Card components as a JSON array matching the X Ads API payload; order defines the render order. A card needs exactly one media component plus a DETAILS or BUTTON component: - \{"type": "MEDIA", "media\_key": "..."} (single image or video from x\_ads\_upload\_media) - \{"type": "SWIPEABLE\_MEDIA", "media\_keys": \["...", "..."]} (2 to 6 items, carousel) - \{"type": "DETAILS", "title": "...", "destination": \{"type": "WEBSITE", "url": "`https://...`"}} (website cards) - \{"type": "BUTTON", "label": \{"type": "ENUM", "value": "INSTALL"}, "destination": \{"type": "APP", "country\_code": "US", "ios\_app\_store\_identifier": "...", "googleplay\_app\_id": "...", "ios\_deep\_link": "...", "googleplay\_deep\_link": "..."}} (app cards; label values: BOOK, CONNECT, INSTALL, OPEN, ORDER, PLAY, SHOP) WEBSITE destinations only go on DETAILS; APP destinations only on BUTTON. Cannot be combined with slides. Example website card: \[\{"type": "MEDIA", "media\_key": "13\_123"}, \{"type": "DETAILS", "title": "Shop now", "destination": \{"type": "WEBSITE", "url": "`https://example.com`"}}] |
| `slides` | string or array of array of object | No | - | For Multi-Destination Carousels: a JSON array of arrays, each inner array a complete card's components (2 to 6 slides). Cannot be combined with components. |

## Output

**Type**: `Dict`

Returns the created card with full details including its card\_uri.

**Fields**: dynamic (depend on the inputs)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.