Skip to main content

​
✍️ Create an Audience

Creates a new audience.

​
📤 Request Example

curl -X POST https://betaapi.audiohook.com/v2/companies/:companyUUID/audiences/ \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "request_headers": [
      { "name": "X-Request-Header", "value": "Header value" }
    ],
    "body": {
      "advertiser_id": "1234-abcd-qwer-xcvb",
      "name": "Test audience docs",
      "tags": ["test tag 1", "test tag 2"],
      "topics": ["topic 1", "topic 2"],
      "type": 3
    }
}'

​
✅ Response Example

{"Audience": {"uuid": "test-audience-uuid"}}

​
🌐 HTTP Request

POST /v2/companies/:companyUUID/audiences

​
🧾 Body Parameters

ParameterRequiredTypeDescription
name✅stringName of the new audience
advertiser_id✅stringUUID of the advertiser
type✅intAudience type (1=first_party, 2=liveramp_ids, 3=topics)
tags❌arrayTags for audience
first_party❌arrayArray of first party segments
liveramp_ids❌arrayLiveramp IDs if type=2
topics❌array/stringTopics list or ‘csv’ if file upload
correlation_id❌stringID to match CSV to audience