---
title: "POST /domains/{domainId}/cases"
method: POST
path: "/domains/{domainId}/cases"
---

# POST /domains/{domainId}/cases

`POST /domains/{domainId}/cases`

If you provide a value for `PerformedBy.UserArn` you must also have [connect:DescribeUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeUser.html) permission on the User ARN resource that you provide

Creates a case in the specified Cases domain. Case system and custom fields are taken as an array id/value pairs with a declared data types.

When creating a case from a template that has tag propagation configurations, the specified tags are automatically applied to the case.

The following fields are required when creating a case:

*   `customer_id` - You must provide the full customer profile ARN in this format: `arn:aws:profile:your_AWS_Region:your_AWS_account ID:domains/your_profiles_domain_name/profiles/profile_ID`
    
*   `title`

## Path parameters

- `domainId` string, required

## Request body

- object
  - `templateId` string, required — A unique identifier of a template.
  - `fields` FieldValue[], required — An array of objects with field ID (matching ListFields/DescribeField) and value union data.
    - `id` string, required — Unique identifier of a field.
    - `value` object, required — Union of potential field value types.
      - `stringValue` string — String value type.
      - `doubleValue` number, double — Can be either null, or have a Double number value type. Only one value can be provided.
      - `booleanValue` boolean — Can be either null, or have a Boolean value type. Only one value can be provided.
      - `emptyValue` object — An empty value.
      - `userArnValue` string — Represents the user that performed the audit.
  - `clientToken` string — A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see <a href="https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/">Making retries safe with idempotent APIs</a>.
  - `performedBy` object — Represents the entity that performed the action.
    - `userArn` string — Represents the Amazon Connect ARN of the user.
    - `customEntity` string, password — Any provided entity.
  - `tags` object — A map of of key-value pairs that represent tags on a resource. Tags are used to organize, track, or control access for this resource.

## Response `200`

Success

- CreateCaseResponse
  - `caseId` string, required — A unique identifier of the case.
  - `caseArn` string, required — The Amazon Resource Name (ARN) of the case.

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — ValidationException
- `483` — ThrottlingException
- `484` — AccessDeniedException
- `485` — ConflictException

---

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