Docs / Strand / connectors/aws-eventbridge
AWS EventBridge
Direction: Write Only | Type: aws.eventbridge
Amazon EventBridge connector for sending events to an event bus. This is a forward-only connector for event-driven architectures.
Required Permissions#
The IAM user or role must have the following permissions:
| Operation | Required IAM Permissions |
|---|---|
put_events |
events:PutEvents |
Tip: Scope permissions to specific event bus ARNs to follow the principle of least privilege.
Operations#
| Operation | Direction | Description |
|---|---|---|
put_events |
Write | Send events to an EventBridge event bus |
Connector Configuration#
| Field | Required | Default | Description |
|---|---|---|---|
| Authentication Type | No | api_key |
Uses explicit credentials (the fields below). |
| Region | Yes | - | AWS region code (e.g., us-east-1) |
| Endpoint URL | No | - | Custom endpoint for a self-managed target or an AWS VPC endpoint. Leave empty for AWS. |
| Access Key ID | Conditional | - | AWS access key (encrypted). Required when Authentication Type is api_key |
| Secret Access Key | Conditional | - | AWS secret key (encrypted). Required when Authentication Type is api_key |
| Event Bus Name | No | default |
Default event bus name (can be overridden at node level) |
Node Configuration#
| Field | Required | Default | Description |
|---|---|---|---|
| Event Bus Name | No | default |
Event bus name |
| Source | No | strand |
Event source identifier |
| Detail Type | No | Workflow Event |
Event detail type |
Output#
json
{
"success": true,
"status": "sent",
"data": {
"event_id": "abc-123",
"event_bus": "default"
},
"service": "aws.eventbridge",
"operation": "put_events"
}
Example#
Connector Setup:
json
{
"region": "us-east-1",
"access_key_id": "AKIAIOSFODNN7EXAMPLE",
"secret_access_key": "wJalrXUtnFEMI/K7MDENG...",
"event_bus_name": "my-app-bus"
}
Node Configuration:
- Source:
myapp.orders - Detail Type:
OrderCreated
Tendrl