---
title: "POST /v1/configurations"
method: POST
path: "/v1/configurations"
---

# POST /v1/configurations

`POST /v1/configurations`

Creates a new configuration for the specified configuration name. Amazon MQ uses the default configuration (the engine type and version).

## Request body

- object
  - `authenticationStrategy` 'SIMPLE' | 'LDAP' — Optional. The authentication strategy used to secure the broker. The default is SIMPLE.
  - `engineType` 'ACTIVEMQ' | 'RABBITMQ', required — The type of broker engine. Amazon MQ supports ActiveMQ and RabbitMQ.
  - `engineVersion` string, required — Required. The broker engine's version. For a list of supported engine versions, see <a href="https://docs.aws.amazon.com//amazon-mq/latest/developer-guide/broker-engine.html">Supported engines</a>.
  - `name` string, required — Required. The name of the configuration. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 1-150 characters long.
  - `tags` object — Create tags when creating the configuration.

## Response `200`

Success

- CreateConfigurationResponse
  - `Arn` string — Required. The Amazon Resource Name (ARN) of the configuration.
  - `AuthenticationStrategy` 'SIMPLE' | 'LDAP' — Optional. The authentication strategy associated with the configuration. The default is SIMPLE.
  - `Created` string, date-time — Required. The date and time of the configuration.
  - `Id` string — Required. The unique ID that Amazon MQ generates for the configuration.
  - `LatestRevision` object — The latest revision of the configuration.
    - `Created` string, date-time, required — Required. The date and time of the configuration revision.
    - `Description` string — The description of the configuration revision.
    - `Revision` integer, required — Required. The revision number of the configuration.
  - `Name` string — Required. The name of the configuration. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 1-150 characters long.

## Other responses

- `480` — BadRequestException
- `481` — InternalServerErrorException
- `482` — ConflictException
- `483` — ForbiddenException

---

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