Creating a connector for the EventRouter API

Written by

Yandex Cloud

Updated at July 15, 2025

Management console

CLI

API

In the management console, select the folder where you want to create a connector.
In the list of services, select Serverless Integrations.
In the left-hand panel, select EventRouter.
Select the bus you need.
In the left-hand menu, select Connectors.
In the top-right corner, click Create connector.
In the Source field, select EventRouter API.
Expand Additional parameters:
- Enter a name and description for the connector. The naming requirements are as follows:
  - The name must be from 3 to 63 characters long.
  - It may contain uppercase and lowercase Latin and Cyrillic letters, numbers, hyphens, underscores, and spaces.
  - The first character must be a letter. The last character cannot be a hyphen, underscore, or space.
- Optionally, add labels:
  - Click Add label.
  - Enter a label in key: value format.
  - Press Enter.
- Optionally, enable deletion protection. You cannot delete a connector with this option enabled.
Click Create.

If you do not have the Yandex Cloud CLI installed yet, install and initialize it.

By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific command using the --folder-name or --folder-id parameter.

View the description of the CLI command to create a connector:

yc serverless eventrouter connector create event-service --help

Create a connector for the EventRouter API:
```
yc serverless eventrouter connector create event-service \
  --bus-id <bus_ID> \
  --name <connector_name> \
  --description <connector_description> \
  --labels <label_list> \
  --deletion-protection
```
Where:
- --bus-id: EventRouter bus ID.
- --name: Connector name. Follow these naming requirements:
  - The name must be from 3 to 63 characters long.
  - It may contain uppercase and lowercase Latin and Cyrillic letters, numbers, hyphens, underscores, and spaces.
  - The first character must be a letter. The last character cannot be a hyphen, underscore, or space.
- --description: Connector description. This is an optional parameter.
- --labels: List of labels. This is an optional parameter.
  
  You can specify one or more labels separated by commas in <key1>=<value1>,<key2>=<value2> format.
- --deletion-protection: Connector deletion protection. By default, protection is disabled. You cannot delete a connector with this option enabled. To disable deletion protection, specify --no-deletion-protection. This is an optional parameter.
Result:
```
id: f667savopsoe********
bus_id: f66klk4lvvjf********
folder_id: b1gt6g8ht345********
cloud_id: b1gia87mbaom********
created_at: "2025-06-18T16:44:03.849030Z"
name: my-sample-connector
description: my description
labels:
  no: label
source:
  event_service_source: {}
deletion_protection: true
status: RUNNING
```

To create a connector for the EventRouter API, use the Create REST API method for the connector resource or the ConnectorService/Create gRPC API call.

By default, the system creates a running connector. Stop the connector to prevent it from sending messages to the bus.

Creating a connector for the EventRouter API

Was the article helpful?