---
title: "POST /domainverifications"
method: POST
path: "/domainverifications"
---

# POST /domainverifications

`POST /domainverifications`

Starts the domain verification process for a custom domain name.

## Request body

- object
  - `clientToken` string — A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If you retry a request that completed successfully using the same client token and parameters, the retry succeeds without performing any actions. If the parameters aren't identical, the retry fails.
  - `domainName` string, required — The domain name to verify ownership for.
  - `tags` object — The tags for the domain verification.

## Response `201`

Success

- StartDomainVerificationResponse
  - `id` string, required — The ID of the domain verification.
  - `arn` string, required — The Amazon Resource Name (ARN) of the domain verification.
  - `domainName` string, required — The domain name being verified.
  - `status` 'VERIFIED' | 'PENDING' | 'VERIFICATION_TIMED_OUT', required — The current status of the domain verification process.
  - `txtMethodConfig` object — The TXT record configuration used for domain verification.
    - `value` string, required — The value that must be added to the TXT record for domain verification.
    - `name` string, required — The name of the TXT record that must be created for domain verification.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — ConflictException
- `483` — ThrottlingException
- `484` — ServiceQuotaExceededException
- `485` — InternalServerException

---

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