events:PutEvents

Write

events:PutEvents is a Write access-level action in the events service. Grants permission to send custom events to Amazon EventBridge

Resource types

ARNs that events:PutEvents can be scoped to in an IAM policy.

arn:${Partition}:events:${Region}:${Account}:event-bus/${EventBusName}
event-bus
arn:${Partition}:events:${Region}:${Account}:event-busv2/${EventBusName}/${OpaqueId}
event-busv2

Condition keys

Keys you can use in the Condition block of a policy that grants events:PutEvents.

events:SystemMetadata/AwsDetailType String

Filters access by the detail type recorded in the system metadata of an event forwarded onto an event bus to PutEvents and PutRawEvents actions

events:SystemMetadata/AwsSource String

Filters access by the source recorded in the system metadata of an event forwarded onto an event bus to PutEvents and PutRawEvents actions

events:SystemMetadata/ContentType String

Filters access by the content type declared on an event for PutRawEvents and for forwarded events authorized as PutEvents

events:detail-type ArrayOfString

Filters access by the literal string of the detail-type of the event to PutEvents and PutRule actions

events:eventBusInvocation String

Filters access to PutEvents and PutRawEvents by whether an event was forwarded from an event bus rather than published through a direct API call

events:source ArrayOfString

Filters access by the AWS service or AWS partner event source that generated the event to PutEvents and PutRule actions, or by the configured source of an event source to the CreateEventSource and UpdateEventSource actions. Matches the literal string of the source field of the event

aws:ResourceTag/${TagKey} String

Filters access by tag-value associated with the resource to event bus and rule actions

Example IAM policy

A minimal policy that allows events:PutEvents. Replace "Resource": "*" with a specific ARN to follow least privilege.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowEventsPutEvents",
      "Effect": "Allow",
      "Action": "events:PutEvents",
      "Resource": "*"
    }
  ]
}

Related actions in events

View all events actions →