Create Placement

POST /placement

Use this method to create a new placement.

Headers

Name	Value
Authorization	Basic <token>

Body

{
  name: string,
  is_archived?: boolean,
  account: {
    id : number, // Mandatory, accountId (looks like 1234)
    name?: string,
  },
  tag_id: {     // Default tagId
    id : string, // Mandatory, accountId (looks like '0bonobfw')
    name?: string,
  },
  mappings: {
    tag_id: {
      id : string, // Mandatory, accountId (looks like '0bonobfw')
      name?: string,
    },
    mapping: {
      adunit_code?: string[],
      device?: string[], // desktop | mobile | tablet | tv | other
      domain?: string[], // Domains must be in this format 'domain.com'
      gpid?: string[],
      size?: {
        w: number, // Width
        h: number // Height
      },
    }
  }
}

Response

200 : OK Placement created

{
  "id": number,
  "external_id": string,
  "name": string,
  "is_archived": boolean,
  "tag_id": {
    "id": string,
    "name": string
  },
  "account": {
    "id": number,
    "name": string
  },
  "mappings": {
    "tag_id": {
      "id" : string,
      "name": string,
    },
    "mapping": {
      "adunit_code": string[],
      "device": string[],
      "domain": string[],
      "gpid": string[],
      "size": {
        "w": number,
        "h": number
      },
    }
  }
}

400 : Bad request no account ID provided

{
  "missingProperty": "account_id"
}