CreateConfigurationSet method

Written by

Updated at October 22, 2024

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

Request

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

{
  "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.

A successful request returns 200 OK in the response.

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.