---
title: "POST /configured-audience-model"
method: POST
path: "/configured-audience-model"
---

# POST /configured-audience-model

`POST /configured-audience-model`

Defines the information necessary to create a configured audience model.

## Request body

- object
  - `name` string, required — The name of the configured audience model.
  - `audienceModelArn` string, required — The Amazon Resource Name (ARN) of the audience model to use for the configured audience model.
  - `outputConfig` object, required — Configuration information necessary for the configure audience model output.
    - `destination` AudienceDestination — Defines the Amazon S3 bucket where the configured audience is stored.
      - `s3Destination` object, required — The Amazon S3 bucket and path for the configured audience.
        - `s3Uri` string, required — The Amazon S3 location URI.
    - `roleArn` string — The ARN of the IAM role that can write the Amazon S3 bucket.
  - `description` string — The description of the configured audience model.
  - `sharedAudienceMetrics` SharedAudienceMetrics[], required — Whether audience metrics are shared.
  - `minMatchingSeedSize` integer — The minimum number of users from the seed audience that must match with users in the training data of the audience model. The default value is 500.
  - `audienceSizeConfig` object — <p>Returns the relevance scores at these audience sizes when used in the <a>GetAudienceGenerationJob</a> for a specified audience generation job and configured audience model.</p> <p>Specifies the list of allowed <code>audienceSize</code> values when used in the <a>StartAudienceExportJob</a> for an audience generation job. You can use the <code>ABSOLUTE</code> <a>AudienceSize</a> to configure out audience sizes using the count of identifiers in the output. You can use the <code>Percentage</code> <a>AudienceSize</a> to configure sizes in the range 1-100 percent.</p>
    - `audienceSizeType` 'ABSOLUTE' | 'PERCENTAGE' — Whether the audience output sizes are defined as an absolute number or a percentage.
    - `audienceSizeBins` AudienceSizeValue[] — An array of the different audience output sizes.
  - `tags` object — <p>The optional metadata that you apply to the resource to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define.</p> <p>The following basic restrictions apply to tags:</p> <ul> <li> <p>Maximum number of tags per resource - 50.</p> </li> <li> <p>For each resource, each tag key must be unique, and each tag key can have only one value.</p> </li> <li> <p>Maximum key length - 128 Unicode characters in UTF-8.</p> </li> <li> <p>Maximum value length - 256 Unicode characters in UTF-8.</p> </li> <li> <p>If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.</p> </li> <li> <p>Tag keys and values are case sensitive.</p> </li> <li> <p>Do not use aws:, AWS:, or any upper or lowercase combination of such as a prefix for keys as it is reserved for AWS use. You cannot edit or delete tag keys with this prefix. Values can have this prefix. If a tag value has aws as its prefix but the key does not, then Clean Rooms ML considers it to be a user tag and will count against the limit of 50 tags. Tags with only the key prefix of aws do not count against your tags per resource limit.</p> </li> </ul>
  - `childResourceTagOnCreatePolicy` 'FROM_PARENT_RESOURCE' | 'NONE' — <p>Configure how the service tags audience generation jobs created using this configured audience model. If you specify <code>NONE</code>, the tags from the <a>StartAudienceGenerationJob</a> request determine the tags of the audience generation job. If you specify <code>FROM_PARENT_RESOURCE</code>, the audience generation job inherits the tags from the configured audience model, by default. Tags in the <a>StartAudienceGenerationJob</a> will override the default.</p> <p>When the client is in a different account than the configured audience model, the tags from the client are never applied to a resource in the caller's account.</p>

## Response `200`

Success

- CreateConfiguredAudienceModelResponse
  - `configuredAudienceModelArn` string, required — The Amazon Resource Name (ARN) of the configured audience model.

## Other responses

- `480` — ConflictException
- `481` — ValidationException
- `482` — AccessDeniedException
- `483` — ResourceNotFoundException
- `484` — ServiceQuotaExceededException

---

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