Queue a carousel of a product

Queue a multi-slide carousel (Instagram and TikTok slides) for one catalog product, built only from its real facts: 3 credits per set, a few minutes to render. format picks the content idea (e.g. a save-this cheat sheet or a myth vs fact), style picks the visual look; leave either out and CartViral rotates to a format/style combo it hasn't tried recently for this account. Credits are charged from the account; a failed set refunds automatically. Poll list_carousels for download links.

post/carousels

Request

  • Base URL: https://app.cartviral.com/api/v1
  • URL: https://app.cartviral.com/api/v1/carousels
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.cartviral.com/oauth/authorize, token URL https://app.cartviral.com/oauth/token, scopes: mcp)

Request body

product_idstring required

Product id from list_products

format'cheat_sheet' | 'myth_vs_fact' | 'this_or_that' | 'vs_usual_way' | 'before_after' | 'listicle' | 'how_to_routine' | 'gift_guide' | 'behind_the_scenes' | 'customer_story' | 'origin_story' | 'unpopular_opinion'

Optional carousel format id; omit to let CartViral pick one

style'editorial' | 'cinematic' | 'comic' | 'social'

Optional visual style id; omit to let CartViral pick one

Response

Success

object required

Changes

No recorded changes to this operation across all 1 revision of this API.