# Flow notifications
<a name="flow-notifications"></a>

Amazon AppFlow is integrated with Amazon EventBridge to publish events related to the status of a flow. The following flow events are published to your default event bus.
+ **AppFlow Start Flow Run Report**: This event is published at the start of a flow run.
+ **AppFlow End Flow Run Report**: This event is published when a flow run is complete.
+ **AppFlow Event Flow Report**: This event is generated every five minutes for an event-triggered flow, and provides a count of event triggers over the five minute interval.
+ **AppFlow Event Flow Deactivated**: This event is generated when Amazon AppFlow deactivates an event-triggered flow due to a failure. The deactivation reason is specified in the event payload.
+ **AppFlow Scheduled Flow Deactivated**: This event is generated when Amazon AppFlow deactivates a schedule-triggered flow due to a failure. The deactivation field is specified in the event payload.

You can access these events in the EventBridge console by creating an appropriate rule. For the steps to create a rule, see [Creating Amazon EventBridge rules that react to events](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html).

## Common fields
<a name="common-fields"></a>

All event payloads include the following common fields:

**account**  
The 12 digit number identifying the AWS account.

**detail-type**  
The name of the event. See the preceding list of flow events for more information.

**id**  
The unique value generated for every event.

**region**  
The AWS region where the event originated.

**resources**  
The ARNs (AWS Resource Numbers) that identify the resources involved in the event.

**source**  
"aws.appflow".

**time**  
The event timestamp.

**version**  
The flow version. By default, this is set to 0 (zero) in all events.

## Flow event detail fields
<a name="flowevent-detail"></a>

The following fields are available as part of the flow event details:

**created-by**  
The ARN of the user who created the flow.

**destination**  
The details of the destination connector for the flow.

**destination-object**  
The destination object chosen in the flow.

**flow-arn**  
The ARN of the flow.

**flow-name**  
The name of the flow selected at the time of the flow creation.

**source**  
The details of the source connector for the flow.

**source-object**  
The source object chosen in the flow.

**trigger-type**  
The flow trigger.

The following table shows the additional event field details.


| Name of the flow event | Field | Description | 
| --- | --- | --- | 
|  **AppFlow Start Flow Run Report**  |  start-time  |  The timestamp of the start of the flow run.  | 
|  **AppFlow Start Flow Run Report, ** **AppFlow End Flow Run Report**  |  incremental-transfer-time-range  |  The start and end timestamps that Amazon AppFlow sent to the source application, indicating the time range for the incremental record transfer. This is available only for schedule-triggered flows.  | 
|  **AppFlow Event Flow Deactivated, ** **AppFlow Scheduled Flow Deactivated**  |  deactivation-reason  |  The reason for deactivation.  | 
|  **AppFlow Event Flow Deactivated**,  **AppFlow Scheduled Flow Deactivated**  |  deactivation-time  |  The time at which the flow was deactivated.  | 
|  **AppFlow Event Flow Report**  |  status-report  |  The count of event triggers received from the source, and the timestamp of the five minute interval over which this count was calculated. This is available only for event-triggered flows.  | 
|  **AppFlow End Flow Run Report**  |  end-time  |  The timestamp of the flow run completion.  | 
|  **AppFlow End Flow Run Report**  |  num-of-records-processed  |  The number of records from the source that were processed by Amazon AppFlow.  | 
|  **AppFlow End Flow Run Report**  |  num-of-record-failures  |  The number of records that could not be inserted into the destination.  | 
|  **AppFlow End Flow Run Report**  |  data-processed  |  The volume of data (in bytes) that was processed.  | 
|  **AppFlow End Flow Run Report**  |  status  |  The status that indicates if the flow run failed or was successful.  | 
|  **AppFlow End Flow Run Report**  |  error  | The reason for flow run failure in the event of a failed flow. |