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
        • ListConfigurationSets method
        • GetConfigurationSet method
        • CreateConfigurationSet method
        • PutDomainIdentityConfigurationSetAttributes method
        • DeleteConfigurationSet 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. Configurations
  4. CreateConfigurationSet method

CreateConfigurationSet method

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

Creates a configuration in a folder. The folder is selected based on the service account the request originates from.

RequestRequest

POST /v2/email/configuration-sets HTTP/2

Request headersRequest headers

Use common request headers in your requests.

Request bodyRequest body

{
  "ConfigurationSetName": "<configuration_name>",
  "Tags": [
    {
      "Key": "<label_key>",
      "Value": "<label_value>"
    }
  ]
}

Parameter

Description

ConfigurationSetName

Type: String.

Configuration name.

Tags

Type: Array.

Array of labels for the configuration.

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.

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

ResponsesResponses

200 OK200 OK

A successful request returns 200 OK in the response.

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 exceeded the quota.

429 LimitExceededException

The request exceeded the limit.

Was the article helpful?

Previous
GetConfigurationSet method
Next
PutDomainIdentityConfigurationSetAttributes method
Yandex project
© 2025 Yandex.Cloud LLC