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
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
    • Yandex Cloud Partner program
  • Blog
  • Pricing
  • Documentation
© 2025 Direct Cursus Technology L.L.C.
Yandex Cloud Postbox
  • Getting started
  • Access management
  • Pricing policy
    • Authentication with the API
    • How to use the API
    • Signing requests
      • All methods
      • Sending emails
        • GetConfigurationSetEventDestinations method
        • CreateConfigurationSetEventDestination method
        • UpdateConfigurationSetEventDestination method
        • DeleteConfigurationSetEventDestination method
      • Request headers
  • Audit Trails events
  • Release notes

In this article:

  • Request
  • Path parameters
  • Request headers
  • Request body
  • Responses
  • 200 OK
  • Errors
  1. API reference
  2. REST
  3. Subscriptions
  4. CreateConfigurationSetEventDestination method

CreateConfigurationSetEventDestinations method

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

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

RequestRequest

POST /v2/email/configuration-sets/{ConfigurationSetName}/event-destinations HTTP/2

Path parametersPath parameters

Parameter

Description

ConfigurationSetName

Type: String.

Configuration name.

Request headersRequest headers

Use common request headers in your requests.

Request bodyRequest body

{
  "EventDestinationName": "<subscription_name>",
  "EventDestination": {
    "Enabled": <subscription_state>,
    "KinesisFirehoseDestination": {
      "IamRoleArn": "<role>",
      "DeliveryStreamArn": "<data_stream>"
    }
  }
}

Parameter

Description

EventDestinationName

Type: String.

Subscription name.

EventDestinations

Type: Object.

Object with subscription parameters.

Enabled

Type: Boolean.

Subscription state: true for enabled, false for disabled. If the subscription is enabled, email delivery notifications are sent to the specified stream.

KinesisFirehoseDestination

Type: Object.

Object which sets the destination for notifications.

IamRoleArn

Type: String.

This parameter is not used. It is provided for compatibility with AWS.

DeliveryStreamArn

Type: String.

Data stream in Yandex Data Streams notifications are sent to.

Format: arn:yc:yds:<region>::<endpoint>:<stream name>. You can copy the endpoint from the Kinesis API endpoint field of the appropriate stream in Data Streams.

Example

arn:yc:yds:ru-central1::https://yds.serverless.yandexcloud.net/ru-central1/b1gkgm9daf9605nj****/etn5nuveugdr18ak****:postbox

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 subscription 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
GetConfigurationSetEventDestinations method
Next
UpdateConfigurationSetEventDestination method
© 2025 Direct Cursus Technology L.L.C.