Create audience - Audiohook Developer Docs

✍️ 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

Parameter	Required	Type	Description
name	✅	string	Name of the new audience
advertiser_id	✅	string	UUID of the advertiser
type	✅	int	Audience type (1=first_party, 2=liveramp_ids, 3=topics)
tags	❌	array	Tags for audience
first_party	❌	array	Array of first party segments
liveramp_ids	❌	array	Liveramp IDs if type=2
topics	❌	array/string	Topics list or ‘csv’ if file upload
correlation_id	❌	string	ID to match CSV to audience