Docs / Contact / connectors/aws-eventbridge

AWS EventBridge

Provider: aws | Service: eventbridge | Direction: Write

Amazon EventBridge connector for putting events onto an event bus. This is a forward-only connector for event-driven architectures.

Required Permissions#

Operation Required IAM Permissions
Put events events:PutEvents
Tip: Scope permissions to the specific event bus ARN to follow the principle of least privilege.

Operation#

When a message reaches this connector, it publishes one event to the configured event bus. The payload must supply:

Payload field Required Description
source Yes Event source identifier
detail_type Yes Event detail type
detail Yes Event detail (JSON string)

Connector Configuration#

The connector is created with type: "cloud", provider: "aws", service_type: "eventbridge", plus:

Field (config) Required Description
region No AWS region code. Derived automatically if event_bus_name is a full ARN.
access_key Yes AWS access key.
secret_key Yes AWS secret key.
event_bus_name Yes Event bus name or ARN

Output#

json

{
  "status": "completed",
  "statusCode": 200,
  "data": {
    "status": "published",
    "statusCode": 200,
    "method": "EVENTBRIDGE_PUT_EVENTS",
    "endpoint": "my-app-bus",
    "duration": 40,
    "response": { "event_bus": "my-app-bus", "source": "myapp.devices", "detailType": "DeviceEvent" }
  }
}

Example#

Connector config (API key):

json

{
  "type": "cloud",
  "provider": "aws",
  "service_type": "eventbridge",
  "region": "us-east-1",
  "access_key": "${secrets.aws_access_key}",
  "secret_key": "${secrets.aws_secret_key}",
  "event_bus_name": "my-app-bus"
}