The /audience/save endpoint will create or update an Audience. If there is no ID for the Audience record, then the operation will create a new record; if the ID is included, then the operation will update the record.

Create

Request

curl -u <user>:<password> -X POST -H "Content-Type: application/json" -d '{"name": "test", "target": "publisher:[\"37\"]","exclude": null}' https://sandbox-api.viant.com/v1/audience/save?adorder_id=15812

Response

{
  "messages": [],
  "entity": {
    "id": 626007,
    "name": "test",
    "target": "grapeshot.custom:[\"2497\",\"887\"] AND publisher:[\"37\"] ",
    "exclude": "dmp.bluekai:[\"24744\",\"34061\"]  AND publisher:[\"107\",\"8\"]  OR viant.taxonomy:[\"51256\",\"51271\",\"52056\"] ",
    "status": "enabled",
    "frequencyCap": "null",
    "lifetimeFrequencyCap": "0",
    "externalAudienceId": null
  }
}

Update

Request

curl -u <user>:<password> -X POST -H "Content-Type: application/json" -d '{"id":626007,"name": "test_update", "target": "publisher:[\"37\"]","exclude": null}' https://sandbox-api.viant.com/v1/audience/save?adorder_id=15812

Response

{
  "messages": [],
  "entity": {
    "id": 626007,
    "name": "test_update",
    "target": "grapeshot.custom:[\"2497\",\"887\"] AND publisher:[\"37\"] ",
    "exclude": "dmp.bluekai:[\"24744\",\"34061\"]  AND publisher:[\"107\",\"8\"]  OR viant.taxonomy:[\"51256\",\"51271\",\"52056\"] ",
    "status": "enabled",
    "frequencyCap": "null",
    "lifetimeFrequencyCap": "0",
    "externalAudienceId": null
  }
}