Jump to Content

This API Documentation is now deprecated

We are excited to announce our new API Documentation.

Class VerifyDomainDkimCommandProtected

Returns a set of DKIM tokens for a domain identity.

When you execute the VerifyDomainDkim operation, the domain that you specify is added to the list of identities that are associated with your account. This is true even if you haven't already associated the domain with your account by using the VerifyDomainIdentity operation. However, you can't send email from the domain until you either successfully verify it or you successfully set up DKIM for it.

You use the tokens that are generated by this operation to create CNAME records. When Amazon SES detects that you've added these records to the DNS configuration for a domain, you can start sending email from that domain. You can start sending email even if you haven't added the TXT record provided by the VerifyDomainIdentity operation to the DNS configuration for your domain. All email that you send from the domain is authenticated using DKIM.

To create the CNAME records for DKIM authentication, use the following values:

  • Name: token._domainkey.example.com

  • Type: CNAME

  • Value: token.dkim.amazonses.com

In the preceding example, replace token with one of the tokens that are generated when you execute this operation. Replace example.com with your domain. Repeat this process for each token that's generated by this operation.

You can execute this operation no more than once per second.

Example

Use a bare-bones client and the command you need to make an API call.

import { SESClient, VerifyDomainDkimCommand } from "@aws-sdk/client-ses"; // ES Modules import
// const { SESClient, VerifyDomainDkimCommand } = require("@aws-sdk/client-ses"); // CommonJS import
const client = new SESClient(config);
const input = { // VerifyDomainDkimRequest
Domain: "STRING_VALUE", // required
};
const command = new VerifyDomainDkimCommand(input);
const response = await client.send(command);
// { // VerifyDomainDkimResponse
// DkimTokens: [ // VerificationTokenList // required
// "STRING_VALUE",
// ],
// };

Param

VerifyDomainDkimCommandInput

Returns

VerifyDomainDkimCommandOutput

See

Throws

SESServiceException

Base exception class for all service exceptions from SES service.

Example

VerifyDomainDkim

// The following example generates DKIM tokens for a domain that has been verified with Amazon SES:
const input = {
"Domain": "example.com"
};
const command = new VerifyDomainDkimCommand(input);
const response = await client.send(command);
/* response ==
{
"DkimTokens": [
"EXAMPLEq76owjnks3lnluwg65scbemvw",
"EXAMPLEi3dnsj67hstzaj673klariwx2",
"EXAMPLEwfbtcukvimehexktmdtaz6naj"
]
}
*/
// example id: verifydomaindkim-1469049503083

Hierarchy

Constructors

Properties

Methods

Constructors

Properties

Methods