Back to Novu

Email

docs/agents/channels/email.mdx

3.19.02.6 KB
Original Source

Use email as a messaging channel for your agent. Novu preserves standard email threading, delivers HTML replies with action links, and can request tool approval in-thread. Email is request/response only: no typing indicator or plan card.

Capabilities

CapabilitySupport
Full context historyYes
Threaded replies (email threading)Yes
Live typing indicatorNo
React with eyes on the original emailYes
Plan cardNo
Rich textHTML
Tap-to-respondYes (action links in the body)
Emoji reactionsGmail only (limited set)
Message edits in placeNo
Action / MCP tool approvalYes (action links)
MCP connect cardYes (action links)
Resolve conversationYes
File sharingNot yet
Streaming word-by-wordNot yet

Full matrix: Channels overview.

Examples

Inbound email

A user emails the agent address. Novu reacts with eyes on the original message while the agent runs, then sends a threaded HTML reply with optional action links.

Tool approval

Gated tools send Approve / Deny action links in a follow-up email. The handler resumes after the user clicks a link.

Setup

Framework / PlatformGuide
Custom code agentFollow a connect guide, then add email as another provider
Managed agentClaude or AWS Claude, then link email in the dashboard

Email provider credentials are configured in the Novu dashboard when you add the provider.

Connect component

@novu/react does not ship an email connect button. Email connections are address-based: configure the email provider on the agent in the dashboard (or via the Agents API). Users reach the agent by emailing that address; threading is handled by ACI.

For Slack, Teams, and Telegram embeddable buttons, see Connect components.

<Columns cols={2}> <Card href="/agents/custom-code-agent/building-blocks/reply" title="Reply" icon="message-square"> HTML / markdown replies and action links. </Card> <Card href="/agents/custom-code-agent/building-blocks/tool-approval" title="Tool approval" icon="shield-check"> Approve / Deny via action links. </Card> <Card href="/agents/custom-code-agent/building-blocks/signals" title="Signals" icon="radio"> Resolve the conversation when the thread is done. </Card> <Card href="/agents/channels/overview" title="Channels overview" icon="table"> Compare providers. </Card> </Columns>