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

# POST /voice-connector-groups

`POST /voice-connector-groups`

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

You can include Amazon Chime 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 Amazon Chime Voice Connector group.
  - `VoiceConnectorItems` VoiceConnectorItem[] — The Amazon Chime Voice Connectors to route inbound calls to.
    - `VoiceConnectorId` string, required — The Amazon Chime Voice Connector ID.
    - `Priority` integer, required — The priority associated with the Amazon Chime Voice Connector, with 1 being the highest priority. Higher priority Amazon Chime Voice Connectors are attempted first.

## Response `201`

Success

- CreateVoiceConnectorGroupResponse
  - `VoiceConnectorGroup` object — The Amazon Chime Voice Connector group details.
    - `VoiceConnectorGroupId` string — The Amazon Chime Voice Connector group ID.
    - `Name` string — The name of the Amazon Chime Voice Connector group.
    - `VoiceConnectorItems` VoiceConnectorItem[] — The Amazon Chime Voice Connectors to which to route inbound calls.
      - `VoiceConnectorId` string, required — The Amazon Chime Voice Connector ID.
      - `Priority` integer, required — The priority associated with the Amazon Chime Voice Connector, with 1 being the highest priority. Higher priority Amazon Chime Voice Connectors are attempted first.
    - `CreatedTimestamp` string, date-time — The Amazon Chime Voice Connector group creation time stamp, in ISO 8601 format.
    - `UpdatedTimestamp` string, date-time — The updated Amazon Chime Voice Connector group time stamp, in ISO 8601 format.
    - `VoiceConnectorGroupArn` string — The ARN of the specified Amazon Chime 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.md) · [All operations](https://skmtc.net/aws/apis/chime/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/chime/versions/40da18840201/schema)