> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Email

> Mail arriving in and leaving connected mailboxes, and what recipients do with mail a workflow or sequence sent.

## Overview

Seven triggers, in two families that come from different places.

**Mailbox events** come from a connected mailbox:
[`email.received`](/dev/webhooks/events/email-received),
[`email.replied`](/dev/webhooks/events/email-replied),
[`email.sent`](/dev/webhooks/events/email-sent) and
[`email.bounced`](/dev/webhooks/events/email-bounced). The first three share one
payload, and they fire only for mail in a thread that is a **conversation** in
Custral. Whether a thread becomes one is decided by the workspace's **New mail
handling** setting, or by a mailbox's own override of it, so mail that setting
leaves in the inbox sends nothing.

Which of the three a message delivers depends on who sent it. Mail from outside
the workspace delivers `email.received` and `email.replied`. Mail from one of the
workspace's own connected mailboxes delivers `email.sent`. Mail the provider
files as spam delivers nothing.

**Engagement events** come from mail a workflow or a sequence sent through its
**Send email** step: [`email.opened`](/dev/webhooks/events/email-opened),
[`email.clicked`](/dev/webhooks/events/email-clicked) and
[`email.unsubscribed`](/dev/webhooks/events/email-unsubscribed). They are driven
by the tracking pixel, the tracked links and the unsubscribe link that step
adds, so mail typed in the inbox composer produces none of them.

<Warning>
  **Every incoming message delivers two events.** `email.received` and
  `email.replied` fire together, with the same `messageId`. Subscribe to one of
  them, or branch on the `event` field.
</Warning>

No payload carries a message body. Mailbox events carry the addressing, the
subject and the ids, and a receiver that needs the content reads the
conversation's messages from the
[Conversations API](/dev/api-reference/conversations).

## Related documentation

<CardGroup cols={2}>
  <Card title="Email" icon="envelope" href="/comms/email/overview">
    Connecting a mailbox and working the inbox.
  </Card>

  <Card title="How threading works" icon="code-branch" href="/comms/email/threading">
    How messages group into the threads these payloads name.
  </Card>

  <Card title="Sequences" icon="list-ol" href="/automation/sequences/overview">
    Automated sends, whose opens and clicks these events report.
  </Card>

  <Card title="Suppressions" icon="ban" href="/comms/suppressions/overview">
    What happens to an address after it unsubscribes.
  </Card>
</CardGroup>

## Triggers

<CardGroup cols={1}>
  <Card title="email.received" icon="inbox" href="/dev/webhooks/events/email-received">
    A message from outside the workspace arrived in a connected mailbox, in a
    thread that is a conversation.
  </Card>

  <Card title="email.replied" icon="reply" href="/dev/webhooks/events/email-replied">
    Fires alongside `email.received` for every incoming message, the first one in
    a thread included.
  </Card>

  <Card title="email.sent" icon="paper-plane" href="/dev/webhooks/events/email-sent">
    A message from one of the workspace's connected mailboxes, in a thread that is
    a conversation.
  </Card>

  <Card title="email.opened" icon="envelope-open" href="/dev/webhooks/events/email-opened">
    Mail a workflow or sequence sent was opened, as reported by its tracking
    pixel.
  </Card>

  <Card title="email.clicked" icon="arrow-pointer" href="/dev/webhooks/events/email-clicked">
    A tracked link in mail a workflow or sequence sent was clicked.
  </Card>

  <Card title="email.bounced" icon="triangle-exclamation" href="/dev/webhooks/events/email-bounced">
    A message sent from a connected mailbox bounced.
  </Card>

  <Card title="email.unsubscribed" icon="ban" href="/dev/webhooks/events/email-unsubscribed">
    A recipient used the unsubscribe link in mail a workflow or sequence sent.
  </Card>
</CardGroup>


## Related topics

- [Email](/comms/email/overview.md)
- [email.clicked](/dev/webhooks/events/email-clicked.md)
- [email.replied](/dev/webhooks/events/email-replied.md)
- [email.unsubscribed](/dev/webhooks/events/email-unsubscribed.md)