---
title: "PUT /contact-flows/{InstanceId}"
method: PUT
path: "/contact-flows/{InstanceId}"
---

# PUT /contact-flows/{InstanceId}

`PUT /contact-flows/{InstanceId}`

Creates a flow for the specified Amazon Connect instance.

You can also create and update flows using the [Amazon Connect Flow language](https://docs.aws.amazon.com/connect/latest/APIReference/flow-language.html).

## Path parameters

- `InstanceId` string, required

## Request body

- object
  - `Name` string, required — The name of the flow.
  - `Type` 'CONTACT_FLOW' | 'CUSTOMER_QUEUE' | 'CUSTOMER_HOLD' | 'CUSTOMER_WHISPER' | 'AGENT_HOLD' | 'AGENT_WHISPER' | 'OUTBOUND_WHISPER' | 'AGENT_TRANSFER' | 'QUEUE_TRANSFER', required — The type of the flow. For descriptions of the available types, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/create-contact-flow.html#contact-flow-types">Choose a flow type</a> in the <i>Amazon Connect Administrator Guide</i>.
  - `Description` string — The description of the flow.
  - `Content` string, required — The content of the flow.
  - `Tags` object — The tags used to organize, track, or control access for this resource. For example, { "tags": {"key1":"value1", "key2":"value2"} }.

## Response `200`

Success

- CreateContactFlowResponse
  - `ContactFlowId` string — The identifier of the flow.
  - `ContactFlowArn` string — The Amazon Resource Name (ARN) of the flow.

## Other responses

- `480` — InvalidRequestException
- `481` — InvalidContactFlowException
- `482` — InvalidParameterException
- `483` — DuplicateResourceException
- `484` — LimitExceededException
- `485` — ResourceNotFoundException
- `486` — ThrottlingException
- `487` — InternalServiceException

---

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