Email-to-task

Forward an email to a unique address and get a task.

Overview

Each tenant registers one or more aliases (e.g. atlas-abc123@in.your-domain.com). When the MX gateway posts an inbound email signed with ATLAS_INBOUND_EMAIL_SECRET, Atlas mints a task in the alias's default project.

Highlights

HMAC-signed webhook (not raw SMTP - keeps the API surface small)
Per-alias default project + default assignee
Every inbound email is persisted in InboundEmail regardless of success

Important to know

ATLAS_INBOUND_EMAIL_SECRET must be set on the api service. See docs/operations-prerequisites.md.
Attachments are not yet ingested; body goes into the task description.

How to use it

Settings Email-to-task New alias (picks the default project).
Configure your MX gateway to POST to /inbound-email/hook.
Forward emails to the alias; tasks appear.

Atlas docs · Atlas - the AI-native work platform