Assign creatives to audiences

Assign multiple creatives to multiple audiences

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

Request

POST /creative/assignToAudiences

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 audiences

curl -u <user>:<password> -X POST -H "Content-Type: application/json" -d '{"entityIds":[544623,544624],"creativeIds":[82877,31233]}' https://sandbox-api.viant.com/v1/creative/assignToAudiences

Response

{
  "messages": [],
  "entity": [
    {
      "entityId": 544623,
      "results": [
	      {
          "creativeId": 82877,
          "Result": "SUCCESS"
        },{
          "creativeId": 31233,
          "Result": "SUCCESS"
        }
      ]
    },{
      "entityId": 544624,
      "results": [
	      {
          "creativeId":31233,
          "Result": "SUCCESS"
        },{
          "creativeId": 82877,
          "Result": "SUCCESS"
        }
      ]
    }
  ]
}
Body Params
entityIds
array of int32s
required
entityIds*
creativeIds
array of int32s
required
creativeIds*
Responses

401

Unauthorized

403

Forbidden

404

Not Found

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