---
title: "POST /voice-connector-groups"
method: POST
path: "/voice-connector-groups"
---

# POST /voice-connector-groups

`POST /voice-connector-groups`

Creates an Amazon Chime SDK Voice Connector group under the administrator's AWS account. You can associate Amazon Chime SDK Voice Connectors with the Voice Connector group by including `VoiceConnectorItems` in the request.

You can include Voice Connectors from different AWS Regions in your group. This creates a fault tolerant mechanism for fallback in case of availability events.

## Request body

- object
  - `Name` string, required — The name of the Voice Connector group.
  - `VoiceConnectorItems` VoiceConnectorItem[] — Lists the Voice Connectors that inbound calls are routed to.
    - `VoiceConnectorId` string, required — The Voice Connector ID.
    - `Priority` integer, required — The priority setting of a Voice Connector item. Calls are routed to hosts in priority order, with 1 as the highest priority. When hosts have equal priority, the system distributes calls among them based on their relative weight.

## Response `201`

Success

- CreateVoiceConnectorGroupResponse
  - `VoiceConnectorGroup` object — The details of the Voice Connector group.
    - `VoiceConnectorGroupId` string — The ID of a Voice Connector group.
    - `Name` string — The name of a Voice Connector group.
    - `VoiceConnectorItems` VoiceConnectorItem[] — The Voice Connectors to which you route inbound calls.
      - `VoiceConnectorId` string, required — The Voice Connector ID.
      - `Priority` integer, required — The priority setting of a Voice Connector item. Calls are routed to hosts in priority order, with 1 as the highest priority. When hosts have equal priority, the system distributes calls among them based on their relative weight.
    - `CreatedTimestamp` string, date-time — The Voice Connector group's creation time stamp, in ISO 8601 format.
    - `UpdatedTimestamp` string, date-time — The Voice Connector group's creation time stamp, in ISO 8601 format.
    - `VoiceConnectorGroupArn` string — The ARN of the Voice Connector group.

## Other responses

- `480` — BadRequestException
- `481` — ForbiddenException
- `482` — AccessDeniedException
- `483` — UnauthorizedClientException
- `484` — ThrottledClientException
- `485` — ResourceLimitExceededException
- `486` — ServiceUnavailableException
- `487` — ServiceFailureException

---

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