auto_write

Has the designer turn one brief into a campaign set: first a plan of several concepts that each lead with a different id

Has the designer turn one brief into a campaign set: first a plan of several concepts that each lead with a different idea (the benefit, a problem it solves, proof from the business's own reviews or numbers, a running offer, the product itself, the story behind it, an occasion), then one design per concept, kept together as one test group to run against each other. Ad platforms judge near-identical ads as one, so a concept too close to one already planned is dropped rather than designed; the set can come back smaller than asked, and with fewer than two distinct concepts it fails. Same brand, records and claim rules as composing a single design. Queued: returns a request id. Uses credits for the plan and for each design.

post/api/v1/tools/create_campaign_set

Request

  • Base URL: https://app.magistry.io
  • URL: https://app.magistry.io/api/v1/tools/create_campaign_set
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.magistry.io/api/oauth/authorize, token URL https://app.magistry.io/api/oauth/token, scopes: creative:write)

Request body

briefstring required

What the campaign is for and what it should get across.

count3 | 4 | 5

How many concepts to plan (default 3).

placementsstring[]

Layouts: square 1:1, portrait 4:5, story 9:16, landscape 1.91:1, wide 16:9. Default square, portrait and story.

duration_secondsnumber

0 for still images (default); up to 60 for videos.

musicboolean

Videos only: lay an instrumental track made for its length under it (default true). False exports a silent video.

music_moodstring

Videos only: the mood of that track. Left out, the brand kit's music mood.

media_idsstring[]

Images from the store's studio library to build on.

product_idsstring[]

Products from the store's catalogue to feature: the designer gets their names and prices, and their pictures where the studio can show them.

job'spotlight' | 'offer' | 'new' | 'proof' | 'how_it_works' | 'before_after' | 'why_us' | 'tip' | 'event' | 'availability' | 'hours' | 'milestone' | 'team' | 'hiring' | 'seasonal'

What the designs are for; each concept follows that job's structure. Leave it out to let the brief decide.

Response

Tool result

okboolean required
resultunknown required

Changes

No recorded changes to this operation across all 3 revisions of this API.