> ## Documentation Index
> Fetch the complete documentation index at: https://developer.audiohook.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create audience

## ✍️ Create an Audience

Creates a new audience.

### 📤 Request Example

```bash theme={null}
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

```json theme={null}
{"Audience": {"uuid": "test-audience-uuid"}}
```

### 🌐 HTTP Request

```http theme={null}
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                               |

***