# `create_carousel`

_Studio_

`write` `10/day`

Create a new Instagram carousel in the Carousel Studio from an idea or brief: Dalea plans it, writes every slide in the brand's voice and language, and paints the artwork, exactly as the Studio does. Returns at once with the draft id and a status of "generating"; the carousel takes 1 to 3 minutes and the widget in the chat fills in by itself. Do not poll: call get_carousel_generation once when the user asks whether it is done, or before scheduling it with schedule_carousel_post. Write the idea as a short brief in the user's words (topic, angle, who it is for, what the last slide should ask). Confirm the brief with the user before calling. Counts toward the brand's monthly carousel limit.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `brandId` | `string` | no |  |
| `idea` | `string` | yes | The brief: topic, angle, audience and the closing ask. Can include the points each slide should make. |
| `funnel` | `"tofu" \| "mofu" \| "bofu"` | no | tofu = reach, mofu = followers, bofu = sales. Default tofu. |
| `slideCount` | `integer` | no | Leave out to let the plan decide. |
| `templateId` | `string` | no | One of: clean_editorial, cinematic_poster, tweet_post, contrast_split, numbered_list, headline_editorial, post_behind_subject, post_card, post_bar, post_split, post_solid, post_paper. Leave out to let Dalea pick for the idea. |
| `textAmount` | `"little" \| "medium" \| "lot"` | no | How much copy per slide: little, medium or lot. Default medium. |
| `illustration` | `"3d" \| "flat" \| "line_art" \| "cartoon" \| "editorial" \| "children" \| "concept_art" \| "poster" \| "vintage"` | no | Illustration style for illustrated templates. Default 3d. |
| `coverHeadline` | `string` | no | Exact text for the cover slide, when the user already wrote it. |
| `language` | `string` | no | BCP-47 code (pt-BR, en, es…) used only when the brand has no content language set. |
| `contentId` | `string` | no | Link the carousel to one of the brand's content cards. |

## Example

### Prompt

```text
Make me a carousel about the three mistakes new creators make when pricing a brand deal.
```

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_carousel",
    "arguments": {
      "idea": "example idea"
    }
  }
}
```

### curl

```bash
curl -X POST https://app.usedalea.ai/api/mcp/mcp \
  -H "Authorization: Bearer dalea_mcp_..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"create_carousel","arguments":{"idea":"example idea"}}}'
```