WorkestraDocs
ModulesProjectsIntegrations

Email → Task

Create tasks by sending an email to your project's dedicated address.

Forward or send an email to a project-specific address, and Workestra turns it into a task — title from the subject, description from the body, attachments preserved, sender captured as the task requester.

email to task

Screenshot needed — add an annotated image showing this UI

The Address Format

Each project has a unique email address of the form:

projects+<project-slug>@<your-domain>

For example, a project with the slug website-redesign on a workspace at acme.workestra.app gets:

projects+website-redesign@acme.workestra.app

Find the full address for any project at Project → Settings → Integrations → Email.

What Gets Created

When an email arrives at that address, Workestra creates a task with:

Task FieldEmail Source
TitleEmail subject
DescriptionEmail body (HTML preserved as Markdown)
AttachmentsAll email attachments
Labels"email" + any labels you've configured as defaults
RequesterSender's email address
ProjectThe project the address points to
StatusProject's default starting status

Who Can Send

By default, only workspace members can send email to task. To allow external senders (e.g. clients, partners), admin can enable it at Project → Settings → Integrations → Email → Allow external senders.

Forwarding Rules

A common pattern: set up a forwarding rule in your mailbox so that any email matching a pattern (e.g. containing "bug report") gets forwarded to your project's email address. The task appears in Workestra automatically.

Reply Handling

Replies to a task-notification email are appended as comments on the original task. The reply-to address on every task notification is unique to that task, so threading works without any setup on your end.

Troubleshooting

If an email didn't become a task:

  • Check Project → Integrations → Email → Recent activity for delivery logs
  • Confirm the sender is allowed (member-only mode blocks externals)
  • Check the project's default status and labels aren't filtering it out of your view

Next Steps

  • Tasks — edit the created task
  • Automations — auto-assign or auto-label emailed tasks