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: