Contact UsGet started

Creating a configuration

Written by
Updated at March 6, 2025

Create a configuration to get email delivery notifications.

  1. In the management console, select the folder containing the address.

  2. Select Cloud Postbox.

  3. In the left-hand panel, select Configurations.

  4. Click Create configuration.

  5. Enter a name and (optionally) a description of the configuration.

  6. Under Subscriptions, click Add:

    1. Enter a name for the subscription.
    2. Select the Yandex Data Streams data stream to send email delivery notifications to. If you do not have a data stream, create one.
    3. Select the Enabled option to activate the subscription.

    You can add multiple subscriptions.

  7. Click Create configuration.

If you do not have the AWS CLI yet, install and configure it.

To create a configuration, assign the postbox.editor role to the service account enabling the AWS CLI.

  1. In the terminal, define these variables:

    ENDPOINT=https://postbox.cloud.yandex.net
PROFILE=<profile_name>
CONFIGSET_NAME=<configuration_name>
IDENTITY=<domain>
KINESIS_ENDPOINT=https://yds.serverless.yandexcloud.net/ru-central1/<directory_ID>/<YDB_database_ID>
TOPIC=<data_stream_name>

  2. Create a configuration:

    aws sesv2 create-configuration-set \
   --endpoint-url=$ENDPOINT \
   --profile $PROFILE \
   --configuration-set-name $CONFIGSET_NAME

  3. Add a subscription to the configuration:

    aws sesv2 create-configuration-set-event-destination \
   --endpoint-url=$ENDPOINT \
   --profile $PROFILE \
   --configuration-set-name $CONFIGSET_NAME \
   --event-destination-name <subscription_name> \
   --event-destination "{\"Enabled\":true,\"KinesisFirehoseDestination\":{\"DeliveryStreamArn\":\"arn:aws:keenesis:::$KINESIS_ENDPOINT:$TOPIC\",\"IamRoleArn\":\"arn:\"}}"

    You can add multiple subscriptions.

To get notifications, link the configuration to an address.

Previous
Templating an email
Next
Linking a configuration to an address