Create campaign creative

Add a creative to a campaign. A campaign serves only once it has a creative it can serve.

Needs the campaigns:write scope, like every campaign write.

A creative is sent to DelivrDSP when it is active and its campaign has launched. One added to a draft campaign is kept until launch, which activates the campaign's draft creatives. One added to a launched campaign is sent as soon as it is active.

Image, video and audio creatives point at an uploaded file: upload it with Create creative upload and Confirm creative upload, then pass the file_id. HTML and NATIVE creatives carry their content in metadata instead, and a file_id is refused for them.

Unknown fields are refused. Refusals are JSON with an error message and a code.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

Campaign ID (UUID).

Body Params
string
enum
required
Allowed:
string
required
length between 1 and 255
string
enum
Defaults to draft
Allowed:
uuid

The uploaded asset, from Confirm creative upload. Required for image, video and audio types; refused for HTML and NATIVE.

string

Where a click goes. An absolute http or https URL.

string

The advertiser's domains, comma-separated hostnames with no scheme or path.

string
metadata
object

Type-specific content.

  • HTML: the markup in creativeHtml, or an absolute URL to a hosted bundle in bundle, and the banner size in imageWidth and imageHeight (positive integers).
  • NATIVE: the title in nativeTitle, plus its images in nativeImages.

A missing or malformed key is refused with a code naming it.

Responses

401

Missing or invalid authentication.

404

Campaign not found, or not in the key's organization.

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