We’ve migrated our documentation to a new site, which means some URLs have changed.
Audience

/widget/creative/create

Create a creative.

The user must be authenticated and have write permissions to the template site group.

Request

The request object has the following fields:

Name

Type

Required

Description

templateId

String

Yes

The template this creative should adhere to.

name

String

Yes

The creative name.

elements

Array of Element objects

Yes

The creative elements.

offerProductId

String

No

The identifier of the product this creative is affiliated with.

Each Element object has the following fields:

Name

Type

Required

Description

name

String

Yes

The name of the element.

type

String

Yes

The type of element, either image, text or url.

The elements should correspond in name and type with elements from the template. All elements marked as required in the template must be present.

Image type

When type is image, the element additionally has the following fields:

Name

Type

Required

Description

data

String

Yes

Base64 encoded image data. Image dimensions must match the width and height from the template.

filename

String

Yes

Image filename with an appropriate file extension, either .gif, .jpg, .jpeg or .png.

Text type

When type is text, the element additionally has the following fields:

Name

Type

Required

Description

text

String

Yes

The text that will be delivered to the end user.

URL type

When type is url, the element additionally has the following fields:

Name

Type

Required

Description

url

String

Yes

The URL that will be delivered to the end user.

Response

The response object has the following fields:

Name

Type

Description

id

String

Identifier for the creative.

Last updated: