> For the complete documentation index, see [llms.txt](https://docs.bird.com/applications/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bird.com/applications/automation/flows/concepts/triggers/message-lifecycle-triggers.md).

# Message lifecycle triggers

Message lifecycle triggers are events that occur during the lifetime of a message in MessageBird.

These triggers allow you to scan, filter, and configure message payloads for better deliverability rates and for content redaction. By using message lifecycle triggers, you can automate message processing tasks and reduce the amount of manual intervention required.

### Message lifecycle trigger events

There are seven types of message lifecycle trigger events:

* [New message received](#new-message-received)
* [Before outgoing message processing](#before-outgoing-message-processing)
* [Before incoming message processing](#before-incoming-message-processing)
* [Message successfully sent](#message-successfully-sent)
* [Message sending failed](#message-sending-failed)
* [Message delivered](#message-delivered)
* [Message delivery failed](#message-delivery-failed)

### New message received

Run a flow when a new message is received by MessageBird.

You can use this trigger to apply content filters.

### Before outgoing message processing

Run a flow before an outgoing message is processed.

You can use this trigger to modify the message payload, apply encryption, or send a copy to another system for archiving.

### Before incoming message processing

Run a flow before an incoming message is processed by the system.

You can use this trigger to scan incoming messages for profanity or apply content filters.

### Message successfully sent

Run a flow when a message has been successfully sent to a recipient.

### Message sending failed

Run a flow when a message fails to be sent to a recipient.

You can use this trigger to retry sending the message, notify the sender of the failure, or escalate the issue to a support team.

### Message delivered

Run a flow when a message has been successfully delivered to a recipient.

### Message delivery failed

Run a flow when a message has been sent but fails to be delivered to a recipient.

You can use this trigger to retry delivering the message, notify the sender of the failure, or escalate the issue to a support team.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.bird.com/applications/automation/flows/concepts/triggers/message-lifecycle-triggers.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.