---
title: "PUT /queues/{InstanceId}"
method: PUT
path: "/queues/{InstanceId}"
---

# PUT /queues/{InstanceId}

`PUT /queues/{InstanceId}`

This API is in preview release for Amazon Connect and is subject to change.

Creates a new queue for the specified Amazon Connect instance.

If the number being used in the input is claimed to a traffic distribution group, and you are calling this API using an instance in the Amazon Web Services Region where the traffic distribution group was created, you can use either a full phone number ARN or UUID value for the `OutboundCallerIdNumberId` value of the [OutboundCallerConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_OutboundCallerConfig) request body parameter. However, if the number is claimed to a traffic distribution group and you are calling this API using an instance in the alternate Amazon Web Services Region associated with the traffic distribution group, you must provide a full phone number ARN. If a UUID is provided in this scenario, you will receive a `ResourceNotFoundException`.

## Path parameters

- `InstanceId` string, required

## Request body

- object
  - `Name` string, required — The name of the queue.
  - `Description` string — The description of the queue.
  - `OutboundCallerConfig` object — The outbound caller ID name, number, and outbound whisper flow.
    - `OutboundCallerIdName` string — The caller ID name.
    - `OutboundCallerIdNumberId` string — The caller ID number.
    - `OutboundFlowId` string — The outbound whisper flow to be used during an outbound call.
  - `HoursOfOperationId` string, required — The identifier for the hours of operation.
  - `MaxContacts` integer — The maximum number of contacts that can be in the queue before it is considered full.
  - `QuickConnectIds` QuickConnectId[] — The quick connects available to agents who are working the queue.
  - `Tags` object — The tags used to organize, track, or control access for this resource. For example, { "tags": {"key1":"value1", "key2":"value2"} }.

## Response `200`

Success

- CreateQueueResponse
  - `QueueArn` string — The Amazon Resource Name (ARN) of the queue.
  - `QueueId` string — The identifier for the queue.

## Other responses

- `480` — InvalidRequestException
- `481` — InvalidParameterException
- `482` — DuplicateResourceException
- `483` — ResourceNotFoundException
- `484` — LimitExceededException
- `485` — ThrottlingException
- `486` — 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)