---
title: "Create audience"
method: POST
path: "/api/cdp/settings/v1/app/{app_id}/audience"
tags: ["Data Activation"]
---

# Create audience

`POST /api/cdp/settings/v1/app/{app_id}/audience`

Create a new Audience. Requires edit permission.

## Path parameters

- `app_id` string, uuid, required — ID of the app.

## Request body

- object — Audience object used for adding and updating audiences
  - `name` string, required
  - `description` string, required
  - `membership_duration_days` integer, required
  - `wait` union — How long to wait after profile matches conditions before adding it to the audience
    - object
      - `seconds` integer, required
    - object
      - `minutes` integer, required
    - object
      - `hours` integer, required
    - object
      - `days` integer, required
  - `definition` union, required
    - object — Standard audience definition. Maximum number of conditions (sum of profile and event conditions) is 10.
      - `operator` 'and', required
      - `conditions` object[], required
        - `operator` 'or', required
        - `conditions` union[], required
          - union
            - object — Audience definition condition based on profile attributes
              - …
            - object — Audience definition condition based on event attributes (behavioral)
              - …
    - object — Sequential audience definition. Filters (second element) are optional.
      - `operator` 'and', required
      - `conditions` unknown[], required
        - unknown

## Response `201`

Created

- object — Full audience object
  - `id` string, uuid, required — ID of the audience
  - `app_id` string, uuid, required — ID of the app
  - `created_at` string, date-time, required — Audience creation date
  - `updated_at` string, date-time, required — Latest audience update date
  - `name` string, required — Name of the audience
  - `description` string, required — Description of the audience
  - `membership_duration_days` integer, required — Time (in days) after which profiles are removed from an audience
  - `wait` union, required — How long to wait after profile matches conditions before adding it to the audience
    - object
      - `seconds` integer, required
    - object
      - `minutes` integer, required
    - object
      - `hours` integer, required
    - object
      - `days` integer, required
  - `definition` union, required
    - object — Standard audience definition. Maximum number of conditions (sum of profile and event conditions) is 10.
      - `operator` 'and', required
      - `conditions` object[], required
        - `operator` 'or', required
        - `conditions` union[], required
          - union
            - object — Audience definition condition based on profile attributes
              - …
            - object — Audience definition condition based on event attributes (behavioral)
              - …
    - object — Sequential audience definition. Filters (second element) are optional.
      - `operator` 'and', required
      - `conditions` unknown[], required
        - unknown
  - `type` 'standard' | 'sequential', required
  - `author` object, required — Author of an audience
    - `email` string, email, required — Email (login) of an author
  - `is_author` boolean, required — Whether the audience was created by the user who issues the request
  - `version` integer, required — Version number, incremented on every update of definition or membership_duration_days

## Other responses

- `400` — Bad request response (e.g. missing GET parameter, parameter value out of bounds)
- `401` — Access token is missing or invalid
- `402` — Data Activation module is disabled
- `404` — Resource not found (bad ID or resource deleted)
- `422` — Data in body does not meet requirements (e.g. missing field)
- `500` — Internal application error response (some service encountered unexpected error)

---

[API](https://skmtc.dev/piwik/apis/web-api.md) · [All operations](https://skmtc.dev/piwik/apis/web-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/piwik/web-api/revisions/f63416a36168/schema)