v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1438230222.0 KB

Creates a domain, which is a container for all customer data, such as customer profile attributes, object types, profile keys, and encryption keys. You can create multiple domains, and each domain can have multiple third-party integrations.

Each Amazon Connect instance can be associated with only one domain. Multiple Amazon Connect instances can be associated with one domain.

Use this API or UpdateDomain to enable identity resolution: set Matching to true.

To prevent cross-service impersonation when you call this API, see Cross-service confused deputy prevention for sample policies that you should apply.

post/domains/{DomainName}

Path parameters

DomainNamestring required

The unique name of the domain.

Request body

DefaultExpirationDaysinteger required

The default number of days until the data within the domain expires.

DefaultEncryptionKeystring

The default encryption key, which is an AWS managed key, is used when no specific type of encryption key is specified. It is used to encrypt all data before it is placed in permanent or semi-permanent storage.

DeadLetterQueueUrlstring

The URL of the SQS dead letter queue, which is used for reporting errors associated with ingesting data from third party applications. You must set up a policy on the DeadLetterQueue for the SendMessage operation to enable Amazon Connect Customer Profiles to send messages to the DeadLetterQueue.

Tagsobject

The tags used to organize, track, or control access for this resource.

Response

Success

DomainNamestring required

The unique name of the domain.

DefaultExpirationDaysinteger required

The default number of days until the data within the domain expires.

DefaultEncryptionKeystring

The default encryption key, which is an AWS managed key, is used when no specific type of encryption key is specified. It is used to encrypt all data before it is placed in permanent or semi-permanent storage.

DeadLetterQueueUrlstring

The URL of the SQS dead letter queue, which is used for reporting errors associated with ingesting data from third party applications.

CreatedAtstring date-time required

The timestamp of when the domain was created.

LastUpdatedAtstring date-time required

The timestamp of when the domain was most recently edited.

Tagsobject

The tags used to organize, track, or control access for this resource.