Create creative

Creates a Creative in your Workspace, either from a file upload or from an external URL. For an upload, supply a filename and you will receive upload instructions in the response; for an external Creative, supply a url instead. Provide exactly one of the two. After completing the upload, poll the Creative by ID until its status transitions to ready or 'error'.

Use cases:

  • Upload a graphic, video, audio, or HTML overlay to use in squeezeback and clipping
  • Register an externally hosted asset as a Creative by its URL
  • Seed a new Creative record and then complete the file upload with the returned instructions
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

The display name of the Creative. Required, and cannot be blank.

string

The name of the file you intend to upload. Supply this to create an uploaded Creative; the response returns the instructions for completing the upload. Provide either filename or url, not both.

string

The name of a separate thumbnail image file to upload alongside the Creative.

uri

The URL of an externally hosted asset to register as a Creative. A Creative created this way is immediately ready. Provide either url or filename, not both.

integer

The pixel width of the media. Supply together with resolution_height when you already know the dimensions. Both must be positive integers.

integer

The pixel height of the media. Supply together with resolution_width when you already know the dimensions. Both must be positive integers.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json