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

# Email Delivery and Status Tracking

> Track the delivery status of emails and manage communication with your customers.

## Overview

Fynn offers comprehensive email delivery tracking, allowing you to view the status of every email sent. You can see whether emails were successfully delivered, opened, or if there were problems with delivery.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/fynnsubscriptionbilling/images/customer-emails-tab-overview.png" alt="Email Overview in Customer Tab" />
</Frame>

## Global Email Overview

In addition to the per-customer view, Fynn provides a tenant-wide email overview where all sent emails can be viewed centrally — regardless of the customer.

### Open the Global List

<Steps>
  <Step title="Navigate to Email Overview">
    Go to **Notifications > Sent Emails** in the left navigation.
  </Step>

  <Step title="Search and Filter Emails">
    The global email list supports the following filters:

    * **Date range**: Filter by send date
    * **Status**: Filter by delivery status (Delivered, Pending, Bounced, Failed, etc.)
    * **Subject**: Full-text search on email subject
    * **Recipient**: Search by recipient email address
    * **Customer**: Restrict to a specific customer
  </Step>
</Steps>

### Cross-Organization View

If a customer is part of an [organization hierarchy](/en/guide/customers/organization-hierarchy), the email list can also display all emails of associated child customers. Enable the **Include parent customer** option when filtering by customer.

## Email Tab in Customer Section

In the customer section, you will find a dedicated "Emails" tab that chronologically lists all emails sent to the customer.

### View Email List

<Steps>
  <Step title="Open Customer Section">
    Navigate to a customer in the [customer overview](https://app.fynn.eu/customers) and select the desired customer.
  </Step>

  <Step title="Open Email Tab">
    Click on the **"Emails"** tab in the customer view.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/fynnsubscriptionbilling/images/customer-emails-tab.png" alt="Email Tab in Customer Section" />
    </Frame>
  </Step>

  <Step title="Browse Email List">
    The email list shows all sent emails with the following information:

    * **Date**: When the email was sent
    * **Subject**: The email subject
    * **Type**: Type of email (invoice, dunning notice, notification, etc.)
    * **Status**: Current delivery status
    * **Opened**: Number of opens

    <Tip>
      For emails with multiple recipients, you will see "To X recipients" under the subject.
    </Tip>
  </Step>
</Steps>

## Understanding Email Status

Each email has a status that indicates the current delivery state. The status badges are color-coded so you can see at a glance whether everything is fine.

### Status Badges

<CardGroup cols={2}>
  <Card title="Pending" icon="clock">
    The email has been queued but has not yet been sent.
  </Card>

  <Card title="Delivered" icon="check-circle">
    The email was successfully delivered to the recipient's email server.
  </Card>

  <Card title="Opened" icon="eye">
    The recipient opened the email. For multiple opens, the count is displayed.
  </Card>

  <Card title="Bounced" icon="exclamation-triangle">
    The email could not be delivered (e.g., invalid email address or full mailbox).
  </Card>

  <Card title="Failed" icon="x-circle">
    Sending the email failed (e.g., server error).
  </Card>

  <Card title="Custom SMTP" icon="envelope">
    The email was sent via a custom SMTP server. Detailed status tracking is not available.
  </Card>
</CardGroup>

<Note>
  The "Custom SMTP" status appears when emails are sent via a custom SMTP server. In this case, detailed status tracking (opens, bounces, etc.) is not possible because the SMTP server does not send webhooks.
</Note>

## View Email Details

For each email, you can view detailed information, including the complete email content and delivery history.

<Steps>
  <Step title="Open Email Details">
    Click on an email in the list to open the detail view.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/fynnsubscriptionbilling/images/customer-email-detail.png" alt="Email Detail View" />
    </Frame>
  </Step>

  <Step title="View Email Information">
    In the detail view, you will find:

    * **Subject**: Complete email subject
    * **Status**: Current delivery status with badge
    * **Delivery Method**: Whether the email was sent via Fynn or a custom SMTP server
    * **From/To**: Sender and all recipients
    * **Sent at**: Time of sending
    * **Delivered at**: Time of delivery (if available)
    * **Opened at**: Time of first open (if available)
  </Step>

  <Step title="View Email Content">
    The complete email content is displayed in a secure preview. This allows you to see how the email arrived at the recipient.

    <Warning>
      The email preview is displayed in a sandboxed environment to ensure security.
    </Warning>
  </Step>
</Steps>

## Status for Multiple Recipients

When an email is sent to multiple recipients, a separate status is tracked for each recipient.

### Per-Recipient Status

<Steps>
  <Step title="Open Email with Multiple Recipients">
    Open the detail view of an email that was sent to multiple recipients.
  </Step>

  <Step title="View Status per Recipient">
    In the detail view, you will find a section **"Status per Recipient"** that shows the individual status for each recipient.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/fynnsubscriptionbilling/images/customer-email-per-receiver-status.png" alt="Status per Recipient" />
    </Frame>

    <Info>
      The overall email status always shows the "worst" status. For example, if an email was sent to three recipients and one bounced, the overall status shows "Bounced", even if the other two were successfully delivered.
    </Info>
  </Step>

  <Step title="Delivery History per Recipient">
    In the delivery history, you can see which events belong to which recipient. Each event is marked with the corresponding recipient.
  </Step>
</Steps>

## Delivery History

The delivery history chronologically displays all important events in an email's lifecycle.

### Available Events

* **Sent**: Email was handed over to the email server
* **Delivered**: Email was successfully delivered
* **Opened**: Recipient opened the email
* **Clicked**: Recipient clicked on a link in the email
* **Bounced**: Email could not be delivered
* **Failed**: Sending failed

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/fynnsubscriptionbilling/images/customer-email-delivery-timeline.png" alt="Delivery History" />
</Frame>

## Email Delivery via Fynn

Fynn offers two ways to send emails, which provide different status tracking capabilities.

### Email Delivery via Fynn (Recommended)

When emails are sent via Fynn, comprehensive status tracking is available:

* Detailed status tracking (Delivered, Opened, Clicked, Bounced)
* Real-time updates via webhooks
* Per-recipient status for multiple recipients
* Complete delivery history

<Note>
  Emails are sent via Fynn by default if no custom SMTP configuration is present.
</Note>

### Email Delivery via Custom SMTP Server

If you have configured a custom SMTP server, emails are sent via that server:

* Basic status tracking (only send success/failure)
* No detailed status tracking (no opens, bounces, etc.)
* Status is displayed as "Custom SMTP"

<Warning>
  For emails sent via a custom SMTP server, detailed status tracking is not possible because SMTP servers do not send webhooks. You will only see whether the email was successfully handed over to the SMTP server.
</Warning>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Why don't I see a status for an email?">
    If an email was just sent, it may take a few seconds for the status to update. For emails sent via Custom SMTP, only a basic status is available.
  </Accordion>

  <Accordion title="What does 'Custom SMTP (no detailed status tracking)' mean?">
    This status appears when emails are sent via a custom SMTP server. In this case, Fynn cannot provide detailed information about opens, bounces, or clicks because the SMTP server does not send webhooks.
  </Accordion>

  <Accordion title="Why does the status show 'Bounced' even though the email was delivered?">
    If an email was sent to multiple recipients and at least one bounced, the overall status shows "Bounced". In the detail view, you can see the status per recipient.
  </Accordion>

  <Accordion title="How is the status updated?">
    For emails sent via Fynn, status updates are automatically updated in real-time. You don't need to refresh the page to see the latest status information.
  </Accordion>

  <Accordion title="Can I see who opened an email?">
    Yes, for emails with multiple recipients, you can see in the detail view which recipient opened the email. The open events are marked with the corresponding recipient in the delivery history.
  </Accordion>
</AccordionGroup>