---
title: "PUT /traffic-distribution-group"
method: PUT
path: "/traffic-distribution-group"
---

# PUT /traffic-distribution-group

`PUT /traffic-distribution-group`

Creates a traffic distribution group given an Amazon Connect instance that has been replicated.

For more information about creating traffic distribution groups, see [Set up traffic distribution groups](https://docs.aws.amazon.com/connect/latest/adminguide/setup-traffic-distribution-groups.html) in the _Amazon Connect Administrator Guide_.

## Request body

- object
  - `Name` string, required — The name for the traffic distribution group.
  - `Description` string — A description for the traffic distribution group.
  - `InstanceId` string, required — The identifier of the Amazon Connect instance that has been replicated. You can find the <code>instanceId</code> in the ARN of the instance.
  - `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>.
  - `Tags` object — The tags used to organize, track, or control access for this resource. For example, { "tags": {"key1":"value1", "key2":"value2"} }.

## Response `200`

Success

- CreateTrafficDistributionGroupResponse
  - `Id` string — The identifier of the traffic distribution group. This can be the ID or the ARN if the API is being called in the Region where the traffic distribution group was created. The ARN must be provided if the call is from the replicated Region.
  - `Arn` string — The Amazon Resource Name (ARN) of the traffic distribution group.

## Other responses

- `480` — InvalidRequestException
- `481` — AccessDeniedException
- `482` — ServiceQuotaExceededException
- `483` — ThrottlingException
- `484` — ResourceNotFoundException
- `485` — InternalServiceException
- `486` — ResourceConflictException
- `487` — ResourceNotReadyException

---

[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)