Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
  • Blog
  • Pricing
  • Documentation
Yandex project
© 2025 Yandex.Cloud LLC
Yandex Cloud Postbox
  • Getting started
  • Access management
  • Pricing policy
    • Authentication with the API
    • How to use the API
    • Signing requests
      • All methods
      • Sending emails
        • ListDomainIdentities method
        • GetDomainIdentity method
        • CreateDomainIdentity method
        • PutDomainIdentityDkimAttributes method
        • DeleteDomainIdentity method
      • Request headers
  • Audit Trails events
  • Release notes

In this article:

  • Request
  • Request headers
  • Request body
  • Responses
  • 200 OK
  • Errors
  1. API reference
  2. REST
  3. Addresses
  4. CreateDomainIdentity method

CreateDomainIdentity method

Written by
Yandex Cloud
Updated at October 22, 2024
  • Request
    • Request headers
    • Request body
  • Responses
    • 200 OK
    • Errors

This method creates an address in a folder. The folder is selected based on the service account the request originates from.

RequestRequest

POST /v2/email/identities HTTP/2

Request headersRequest headers

Use common request headers in your requests.

Request bodyRequest body

{
  "EmailIdentity": "<address>",
  "Tags": [
    {
      "Key": "<label_key>",
      "Value": "<label_value>"
    }
  ],
  "DkimSigningAttributes": {
    "DomainSigningSelector": "<selector_name>",
    "DomainSigningPrivateKey": "<private_key>"
  },
  "ConfigurationSetName": "<configuration_name>"
}

Parameter

Description

EmailIdentity

Type: String.

Address.

Tags

Type: Array.

Address label array.

The maximum number of labels is 50.

Key

Type: String.

Label key.

The keyword may be from 1 to 63 characters long.

Value

Type: String.

Label value.

It may be from 0 (no value) to 256 characters long.

DkimSigningAttributes

Type: Object.

Object containing parameters for creating a DKIM signature.

DomainSigningSelector

Type: String.

Name of the selector used to identify the public key in the domain’s DNS configuration.

The selector name may be from 1 to 63 characters long.

DomainSigningPrivateKey

Type: String.

Private key used to generate a DKIM signature. The private key must use 1,024-bit or 2,048-bit RSA encryption and base64 encoding.

It may be from 1 to 20,480 characters long.

ConfigurationSetName

Type: String.

Name of the configuration you want to link to the address. The configuration must reside in the same folder as the address.

ResponsesResponses

200 OK200 OK

{
  "IdentityType": "<address_type>",
  "VerifiedForSendingStatus": <verification_status_for_sending_emails>,
  "DkimAttributes": {
    "SigningEnabled": <use_DKIM>,
    "Status": "<DKIM_search_status>",
    "Tokens": [
      "<public_key_selector>"
    ],
    "SigningAttributesOrigin": "<DKIM_configuration_method>",
    "NextSigningKeyLength": "<next_key_length>",
    "CurrentSigningKeyLength": "<current_key_length>"
  }
}

Parameter

Description

IdentityType

Type: String.

Address type. The possible value is DOMAIN.

VerifiedForSendingStatus

Type: Boolean.

Indicates whether address ownership is verified. The possible values are true or false.

You can send emails only from verified addresses.

DkimAttributes

Type: Object.

Object containing the DKIM signature parameters.

SigningEnabled

Type: Boolean.

Indicates whether a given address uses DKIM signing for sending emails. The possible values are true or false.

Status

Type: String.

Indicates whether Yandex Cloud Postbox was able to detect a DKIM signature in the DNS configuration of the address. The possible values are:

  • PENDING: Search is in progress, but Yandex Cloud Postbox has not yet detected a DKIM signature in the address DNS configuration.
  • SUCCESS: DKIM signature detected.
  • FAILED: Failed to detect a DKIM signature.
  • TEMPORARY_FAILURE: Yandex Cloud Postbox is not able to detect a DKIM signature due to a temporary issue.
  • NOT_STARTED: Search was not started.

Tokens

Type: Array.

List of selectors for public key identification. Selector type: String.

SigningAttributesOrigin

Type: String.

Indicates how DKIM signing was configured. EXTERNAL: DKIM was configured using BYODKIM.

NextSigningKeyLengths

Type: String.

Used exclusively for compatibility with AWS.

CurrentSigningKeyLength

Type: String.

Used exclusively for compatibility with AWS.

The 200 OK response may contain additional parameters. Its format may vary slightly from the above.

ErrorsErrors

For all errors, the response body has the same format:

{
   "Code": "<error_name>",
   "message": "<error_description>"
}

The name of the error is taken from its code, e.g., BadRequestException.

Possible errors:

Error code

Description

400 BadRequestException

The request contains invalid headers or parameters.

404 NotFoundException

The requested resource was not found.

409 AlreadyExistsException

A configuration with this name already exists. Specify a different name.

409 ConcurrentModificationException

There are conflicting operations. Wait for the previous operation to complete and repeat your request.

429 TooManyRequestsException

The request quota was exceeded.

429 LimitExceededException

The request limit was exceeded.

Was the article helpful?

Previous
GetDomainIdentity method
Next
PutDomainIdentityDkimAttributes method
Yandex project
© 2025 Yandex.Cloud LLC