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

# Email

> Manage Forge email: senders, the SendGrid Inbound Parse token, routes that start workflows from mail, the inbound log, and outbound delivery status.

**Email** (`/platform/email`) shows the senders, the SendGrid inbound token, the routes, and the inbound and outbound logs for forge.gloo.com. It is the **Email** tab of the **Settings** sidebar entry under **Platform**. Open it to start a workflow from inbound mail, to rotate the inbound URL, or to find out why a message was not routed or delivered.

![Email](https://mintcdn.com/gloo-b243725a/xyq5perq6SLByPBn/forge/images/console/platform/email-light.png?fit=max\&auto=format\&n=xyq5perq6SLByPBn\&q=85\&s=fa1b512aa74dbaecef69671a995d9e6f)

Email — Forge Console at `/platform/email`

## Sections

* **Senders**: each sender's **Address**, **Display name**, **Replies**, **Purpose**, and **Sends as**, with a note on which SendGrid Credential sets the From address.
* **Inbound token**: its **Active** or **Paused** state, the **Inbound Parse URL**, and the **Event Webhook URL** for the system and for this org unit.
* **Routes**: columns **Address**, **Kind**, **Workflow**, **Sender policy**, **Rate/min**, **Status** (**Enabled** or **Disabled**), and **Actions**.
* **Inbound log**: **Received**, **From**, **To**, **Subject**, **Disposition**, **Reason**, **Target**, **Attachments**, with **Load more**.
* **Deliveries**: **Created**, **Sender**, **To**, **Subject**, **Status**, **Retries**, **Last error**, **SendGrid message**, with **Load more**.

## What you can do

* **Create inbound token** (when none exists) or **Rotate token** (after confirming "Rotate the inbound email token?"; **Keep current URL** cancels) shows the Inbound Parse URL once. Copy it with **Copy URL** and paste it into SendGrid Inbound Parse; Forge stores only a hash and cannot show it again. **Done** closes the dialog.
* **Pause** makes the Inbound Parse URL answer 410 so SendGrid retries; **Resume** restores the same URL.
* **Create route** opens **New email route**: **Local part**, **Kind** (`workflow: start a run` or `drop: accept and discard`), **Workflow**, **Sender policy** (`any`, `dkim_pass`, or `known_person`, the default), **Rate per minute** (1 to 600), and **Enabled**. Save with **Create route** or **Save route**.
* Per route: **Edit**, **Disable** / **Enable**, and **Delete**, which asks **Keep** or **Delete route**.

> [!WARNING]
>
> Rotation has no grace window: the old URL stops working at once. SendGrid's posts fail until Inbound Parse holds the new URL. Anyone holding the URL can post mail into Forge, so keep it in a secret manager.

## Statuses

| Log | Values |
| - | - |
| Inbound **Disposition** | `received`, `routed`, `dropped`, `rejected`, `unrouted`, `failed` |
| Delivery **Status** | `queued`, `retrying`, `sent`, `delivered`, `bounced`, `dropped`, `spam`, `failed` |

## Who can act

Viewing the senders, inbound token, routes, inbound log and deliveries requires `webhooks:read`. Managing the token and routes requires `webhooks:manage`. Picking a workflow for a route requires `workflows:read`. A workflow route needs an owner; if your sign-in has no worker identity in Forge, you can create only a drop route.

## Key state to watch

* `unrouted` in the inbound log: mail arrived for an address with no route. Add a route if it should start a workflow.
* `rejected` or `failed` dispositions: read **Reason**, then check the route's **Sender policy**.
* An inbound token stuck on **Paused**: SendGrid keeps retrying and mail is not processed.
* `bounced`, `dropped`, `spam`, or `failed` deliveries: read **Last error** and check the recipient address.
* **Retries** climbing on `retrying` deliveries: delivery attempts keep failing; read **Last error**.

## Related surfaces

* [Webhooks](https://docs.gloo.com/forge/console/platform/webhooks.md)
* [Workflows](https://docs.gloo.com/forge/console/production/workflows)
* [Credentials](https://docs.gloo.com/forge/console/platform/credentials.md)
* [Settings](https://docs.gloo.com/forge/console/platform/settings)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.