marketing

Start a marketing project

Make an editable marketing video from something this account already has: a finished WALKTHROUGH render (renderId), or a scanned WEBSITE (source). The project opens at its first revision, which you can rework with marketing.revisions.create and cut with marketing.exports.create. Nothing is charged here — the export is what spends video time. A walkthrough project needs its render's clean source to still be kept; 409 source_not_ready says it is not.

post/marketing/projects

Request

  • Base URL: https://api.gogoscreen.com/api/v1
  • URL: https://api.gogoscreen.com/api/v1/marketing/projects
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Headers

Idempotency-Keystring required

1–128 characters, unique to this request. A retry with the same key and the same body returns the STORED response with Idempotent-Replayed: true; the same key with a different body is 409 idempotency_conflict; a duplicate still in flight is 409 idempotency_in_progress. Claims expire after 24 hours.

Request body

durationSecondsinteger

The length the first revision opens at. Must be one the design offers, from catalog.marketing.templates.list; the six-second edition is retired and is refused here.

format'portrait' | 'landscape' | 'square' | 'four-five' required
renderIdstring uuid

A finished walkthrough render of this account's. Exclusive with source.

reviewobject

Website projects only: the approved copy and scene choices.

templateIdstring required

A design id from catalog.marketing.templates.list.

titlestring

Response

Start a marketing project

Changes

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