Skip to content

Create campaign

POST
/campaigns

Create new campaign

New campaign data

NewCampaign

Input required to create a new campaign

object
name
required

Campaign name

string
type
required

Campaign type

string
adspecId

Default adspec ID for campaign, leave blank to use default for that type

integer

Successfully created new campaign, returning it

object
data
Campaign

Object representing a campaign

object
id

Internal campaign ID

integer
name

Campaign name

string
createdAt

Date of campaign creation

date
updatedAt

Date of last campaign update

date
type

Type of campaign (display/video etc)

string
shareURL

Complete share campaign URL

string
adspecId

Default adspec ID for campaign

integer
userId

User ID of user that created the campaign

integer

401 Authentication failed

401 Authentication failed response

Unable to authenticate user

object
error
Error section

Contains issue information for error responses

object
responseCode

HTTP response code for verification against header response

integer
issues

Detailed information on the issues that triggered the error

Array<object>
Error issue

Issue when returned as part of error section in unsuccessful response

object
type

Advalidation issue type key (please quote when reaching out to support)

string
message

Human readable issue description

string
relatedField

Specific field in the request that the issue relates to

string

422 Unprocessable entity

422 Unprocessable entity

There is something wrong with the content of the request, typically missing or improperly formatted fields

object
error
Error section

Contains issue information for error responses

object
responseCode

HTTP response code for verification against header response

integer
issues

Detailed information on the issues that triggered the error

Array<object>
Error issue

Issue when returned as part of error section in unsuccessful response

object
type

Advalidation issue type key (please quote when reaching out to support)

string
message

Human readable issue description

string
relatedField

Specific field in the request that the issue relates to

string