Create Carousel (from a brief, a product or an article)
create_carouselWrite and design a CAROUSEL from scratch — 4-10 branded slides — when there are no images and no PDF, only a subject. This is the tool for "make a carousel about X", "a LinkedIn document carousel about X", "a slide deck on X". It writes one idea per slide from the brief and the account's own business profile, designs them in the brand, and produces ONE draft post: the slides publish to Instagram, and LinkedIn gets the same deck as a swipeable PDF document rather than an image gallery. Use create_carousel_from_images instead when the user supplies the pictures, and redesign_document when they supply a PDF. Runs in the background for a few minutes — poll get_task_status with the returned taskId, and give the user the returned ownerLink so they can see the slides. A productId whose product has at least two photos always becomes a carousel of those photos, and an account with AI images turned off gets its OWN photos for any source — no slides are designed and no text is drawn on them (the caption carries the message, the brand overlay adds the account's text design); with AI images off it is refused when the account has fewer than two photos. An account that has uploaded its own carousel design (Settings → Brand → Carousels) gets every designed deck in it, and a news-article deck is always designed in it, even with AI images off. For a product, pass design 'template' to design the slides in that uploaded design with the product's photos laid in, instead of a carousel of the photos; it is refused when the account has no uploaded design.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topic | No | What the carousel should say, in the user's own words. Required unless productId or articleId is given, where it becomes the extra steer. | |
| design | No | With productIds: 'photos' for the products' own photos instead of a designed deck. With productId: 'photos' (default): a carousel of the product's own photos. 'template': slides designed in the account's own uploaded carousel design with the product's photos laid in — only when the account has uploaded one. | |
| articleId | No | Make the deck a commentary on one news article (from list_news). | |
| productId | No | Make the carousel about one product — 'shopify-42' or 'feed-17' (from list_products). A product with two or more photos becomes a carousel of those photos with no text on them; its description writes the caption. | |
| productIds | No | Several products (list_products ids), with topic as the angle. Default: a DESIGNED deck — their catalogue facts fill the slides and their photos are composed into the design. With design 'photos': a carousel of their own photos instead, a slide per product, no text drawn on them. Not together with productId or articleId. | |
| slideCount | No | How many slides, 4-10. Default 8. | |
| scheduledFor | No | ISO datetime to schedule the finished post for. Omit to leave it as a draft. |