Assign Creatives to Ad Orders

Assign Creatives to Ad Orders

Request

POST /creative/assignToAdOrders

Request Body

Name Type Description Required
entityIds Number Array Ad Order IDs to assign the creatives to. Yes
creativeIds Number Array Creative IDs to assign to the ad orders. Yes

Response

JSON Fields Type Description
messagesObject ArrayAn array of any error messages.
messages[].levelStringError level.
messages[].codeStringError code.
messages[].messageStringError message.
entityObject ArrayContains results per Ad Order.
entity[].entityIdNumberAd order ID.
entity[].resultsObject ArrayAssignment info for the Ad Order. Empty if all creatives were already assigned.
entity[].results[].creativeIdNumberCreative ID.
entity[].results[].result String Assignment result. Possible values:
  • SUCCESS
    • Creative successfully assigned
  • CAMPAIGN_MISMATCH
    • Creative successfully assigned
  • CHANNEL_MISMATCH
    • Creative successfully assigned

Example

Request to assign creatives to multiple ad orders

curl -u <user>:<password> -X POST -H "Content-Type: application/json" -d '{"entityIds":[145,468652],"creativeIds":[1190,1245219]}' https://sandbox-api.viant.com/v1/creative/assignToAdOrders

Response

{
  "messages": [],
  "entity": [
    {
      "entityId": 145,
      "results": [
        {
          "creativeId": 1190,
          "result": "CHANNEL_MISMATCH"
        }
      ]
    },
    {
      "entityId": 468652,
      "results": []
    }
  ]
}
Language
Credentials
Basic
base64
:
URL
Click Try It! to start a request and see the response here!