---
title: "Create an Audience"
method: POST
path: "/audiences"
tags: ["Audiences"]
---

# Create an Audience

`POST /audiences`

Create an Audience for a Project

## Request body

- Audience
  - `archived` boolean — Whether the Audience has been archived
  - `conditions` string — A string defining the targeting rules for an Audience
  - `created` string, date-time — The time the Audience was initially created
  - `description` string — A short description of the Audience
  - `experiment_count` integer — Number of experiments by audience_id
  - `for_journey` boolean — Whether the Audience has been part of journey or not
  - `id` integer — The unique identifier for the Audience
  - `is_classic` boolean — Whether or not Audience is a classic Audience. If true, the Audience is only compatible with classic Experiments. Otherwise, the Audience may be used in Optimizely X Campaigns.
  - `last_modified` string, date-time — The last time the Audience was modified
  - `name` string — The name of the Audience
  - `project_id` integer, required — The ID of the Project the Audience was created in
  - `segmentation` boolean — True if the Audience is available for segmentation on the results page (Audiences can only be used for segmentation in Optimizely Classic). Set to False if you intend to use this Audience only in Optimizely X. Note that a maximum of 10 Audiences can have segmentation set to True in any given Optimizely Classic project.

## Response `201`

Return the created Audience

- Audience
  - `archived` boolean — Whether the Audience has been archived
  - `conditions` string — A string defining the targeting rules for an Audience
  - `created` string, date-time — The time the Audience was initially created
  - `description` string — A short description of the Audience
  - `experiment_count` integer — Number of experiments by audience_id
  - `for_journey` boolean — Whether the Audience has been part of journey or not
  - `id` integer — The unique identifier for the Audience
  - `is_classic` boolean — Whether or not Audience is a classic Audience. If true, the Audience is only compatible with classic Experiments. Otherwise, the Audience may be used in Optimizely X Campaigns.
  - `last_modified` string, date-time — The last time the Audience was modified
  - `name` string — The name of the Audience
  - `project_id` integer, required — The ID of the Project the Audience was created in
  - `segmentation` boolean — True if the Audience is available for segmentation on the results page (Audiences can only be used for segmentation in Optimizely Classic). Set to False if you intend to use this Audience only in Optimizely X. Note that a maximum of 10 Audiences can have segmentation set to True in any given Optimizely Classic project.

## Other responses

- `default` — Unexpected error

---

[API](https://skmtc.net/optimizely/apis/optimizely-api.md) · [All operations](https://skmtc.net/optimizely/apis/optimizely-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/optimizely/optimizely-api/versions/35d56dc0d1b9/schema)