> For the complete documentation index, see [llms.txt](https://software-help-docs.gitbook.io/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://software-help-docs.gitbook.io/knowledge-base/software-guide/workflow-triggers/workflow-tigger-email-events.md).

# Workflow Tigger: Email Events

*In this article you will find out how to create a workflow trigger: Email Events and the scenarios on why it would be used*

***Please Note:** This trigger only works for Mailgun*

1. Click the “**Add New Workflow Trigger**” button

* This will pull up a selection tab on the right of your screen

{% embed url="<https://lh3.googleusercontent.com/BAHxAHswQG6R9rRXwX0xcUpz9T7tkW8P1Ws263fD79hEp9GIHYXm9y26jrApNW6FgEIVK-jOvIcdTHpUT-gYRl-tQ-qbjr9m8xpwcLlaY_my36hk8D-lCYgEiIsDNw1qDOSPsEHm00I3EoJxvgiYRhY>" %}

1. Scroll down until you see the “**Events”** column

* Click on the “**Email Events**” button
* This will be triggered based on what happens within a particular email

{% embed url="<https://lh6.googleusercontent.com/o6NMsJ0H-n_xv_msajORfbJNLU1W0z5kGU4XrwrBbnFNBSsdVqs4YX9uX8jsXmpC8NPt4m_0Pc58cV0JFeVMooSza0fF3UoHCxs6IUdiYUz6nEJt4XKqaS0J3hB5yAkFbbUyQP-fqtv5EdUKnjbfJaU>" %}

1. Select the blue “Add filters” button

{% embed url="<https://lh5.googleusercontent.com/LmftuHK8TmEKcYQNn_HdBJtdiKWBpaehJY66836j8elBt6e2v9DLJeUsT8zJsd7TN555dLZr4lLyqcuQYBaehxMuk2Xg3uHfyUOaCBXtmu_LgFUux7qy2P1i6kBXM30YV3r1LB7yqK55OA502Me9Tpg>" %}

1. Next under the **Standard Fields** drop-down select the “**Event**” option

{% embed url="<https://lh4.googleusercontent.com/XWAFIk0M0NJ74gMdwzARH8I8wxDFrnfIts_uqYTjr_OKs2oDe-5_YEEea6ZDRh2Jlw8XDisXHKUo9Hknmyvz-J6QblrXOXEbqEVsAsHp21v7f78q-t6NM5Ce2UvJEL3y0Bsz8hcGvywCZi5kPPnZTZk>" %}

1. Select the filter type that applies

* ***Bounced**: an automatic trigger by an email bouncing*
* ***Clicked**: someone clicked on an email*
* ***Complained**: someone marked it as spam (good for filtering over the list that way you do not get marked for spamming too many times because the account can get flagged)*
* ***Opened:** can trigger based on someone opening an email*
* ***Unsubrcided**: someone unsubscribing to an email*

{% embed url="<https://lh6.googleusercontent.com/AWfal3pGQzyOw3COnwFSF_Ee2dlFqIaWsivNNVjR0QeJQ6cjiImQzXAa4hxtnb96duaWwqUzRvnDQPkXfxxZtrRxNAFVl1SSVLYwQ709rONz-g9X0kAr3Rp6pH5ZgCBn8PFKAhDK-pbeaqHrub_JNTA>" %}

1. Example: let’s trigger the automation as if someone “**Opened**” an email
2. Click the blue “**Add filters**” button

* *You will have to specify which email; in this case only works if this email is in another **Workflow***

{% embed url="<https://lh3.googleusercontent.com/_TGcZmARPWiqzunz4DDHQH9U9Al3wTA1_Hux6y8Oxhr4-ijqzuSHm7jq3GNYo9ehSOlIjg2pMxA0TyHgSsXWOOwg_Fa3TPooGEgSFZbacWfCHgc1l28SUfnVqyzsACqj18ZKK6qh9joNSFlDL9XOxTg>" %}

1. Once completed this will pop up a drop-down option. Click the dropdown “**˅**” button

{% embed url="<https://lh3.googleusercontent.com/JVk5np8LFxAsp09RYFAj6CwNGGFKIQ1QdWuw2ZgGCxo4rRuJlw-HJVDlpxhTX9du3UgdgeAxwTy0f-DsF-JV9L4XgP5n3O-nE7VGNaGWSNpFrU6DIOD215kGu1gDrbzUC4TcxfzH83euM8tMvjKUO_w>" %}

1. In the **Standard Feilds** option select “**In workflow**”

* Now click the expand button;
  * *This will give you the ability to choose any of the workflows previously created*
* *In This Example: We will select the “**Meet with Billy Calendar**”*
  * *Letting you know someone opened the email that is in the “**Meet with Billy Calendar**”*
  * *You have now set up this trigger that will let you know the email has been opened*

{% embed url="<https://lh6.googleusercontent.com/Em1okFSLcoRGJ5Z5yyXww-s3iGdOsc3iq__EIzMXQWZo_07QBrQiN_MorK_7fyx5bIZMncaIMGRgmlxwlW0sISYGL5vNkor-ltXutuEQODX5bhMZ42_MlHDYtrfOhrdw3KBFjDCb-tT8_yYAIWzjmYc>" %}

1. Please make sure you click the green “**Save Trigger**” button before closing out of the trigger

{% embed url="<https://lh4.googleusercontent.com/YyfJoRzwwpyhUPfSSlpxFAlA8hfB5S3RzAXbRjSxgqwytMW9M3A-iCTrW0jp3YxQ2iCXQZ0rrlmOFnSFUMz2XBkY2elS76W55KSmGL94jOx97iFXOz56U7Hc-AQsXj9JiWwSZbAdf2mn2h-sjB1fJ8Y>" %}


---

# 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://software-help-docs.gitbook.io/knowledge-base/software-guide/workflow-triggers/workflow-tigger-email-events.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.
