---
title: "POST /domainConfigurations/{domainConfigurationName}"
method: POST
path: "/domainConfigurations/{domainConfigurationName}"
---

# POST /domainConfigurations/{domainConfigurationName}

`POST /domainConfigurations/{domainConfigurationName}`

Creates a domain configuration.

Requires permission to access the [CreateDomainConfiguration](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions) action.

## Path parameters

- `domainConfigurationName` string, required

## Request body

- object
  - `domainName` string — The name of the domain.
  - `serverCertificateArns` AcmCertificateArn[] — The ARNs of the certificates that IoT passes to the device during the TLS handshake. Currently you can specify only one certificate ARN. This value is not required for Amazon Web Services-managed domains.
  - `validationCertificateArn` string — The certificate used to validate the server certificate and prove domain name ownership. This certificate must be signed by a public certificate authority. This value is not required for Amazon Web Services-managed domains.
  - `authorizerConfig` object — An object that specifies the authorization service for a domain.
    - `defaultAuthorizerName` string — The name of the authorization service for a domain configuration.
    - `allowAuthorizerOverride` boolean — A Boolean that specifies whether the domain configuration's authorization service can be overridden.
  - `serviceType` 'DATA' | 'CREDENTIAL_PROVIDER' | 'JOBS' — <p>The type of service delivered by the endpoint.</p> <note> <p>Amazon Web Services IoT Core currently supports only the <code>DATA</code> service type.</p> </note>
  - `tags` Tag[] — <p>Metadata which can be used to manage the domain configuration.</p> <note> <p>For URI Request parameters use format: ...key1=value1&amp;key2=value2...</p> <p>For the CLI command-line parameter use format: &amp;&amp;tags "key1=value1&amp;key2=value2..."</p> <p>For the cli-input-json file use format: "tags": "key1=value1&amp;key2=value2..."</p> </note>
    - `Key` string, required — The tag's key.
    - `Value` string — The tag's value.

## Response `200`

Success

- CreateDomainConfigurationResponse
  - `domainConfigurationName` string — The name of the domain configuration.
  - `domainConfigurationArn` string — The ARN of the domain configuration.

## Other responses

- `480` — LimitExceededException
- `481` — CertificateValidationException
- `482` — ResourceAlreadyExistsException
- `483` — ServiceUnavailableException
- `484` — InternalFailureException
- `485` — InvalidRequestException
- `486` — UnauthorizedException
- `487` — ThrottlingException

---

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