Skip to main content

Set Up Agent Email

Give your agent its own email address so it can send and receive messages independently. In this tutorial, you'll configure inbound and outbound email rules, review your agent's inbox and outbox, and set up approval workflows for outgoing mail.

Prerequisites​

  • An XpressAI Platform account with at least one agent deployed

Steps​

1. Navigate to Email Rules​

Open your agent's profile page. You can get there by clicking Agents in the sidebar, then selecting the agent you want to configure. Switch to the Email Rules tab.

2. Note your agent's email address​

Every agent gets a dedicated email address in the format:

[email protected]

For example, if your agent is named toby, its email address is [email protected]. This address is active as soon as you configure email rules.

3. Configure inbound rules​

Inbound rules define what happens when your agent receives an email. You can set up rules such as:

  • Auto-respond -- the agent reads the incoming email and sends a reply automatically.
  • Forward to conversation -- the email content is posted into a specific conversation channel for you to review.
  • Create task -- the agent creates a task based on the email content and begins working on it.

To add a rule, click Add Rule, select a rule type from the dropdown, and configure the conditions (such as sender address or subject keywords). You can add multiple inbound rules depending on how you want your agent to handle incoming mail.

4. Configure outbound rules​

Outbound rules control how your agent sends emails. The key setting here is whether outbound emails require human approval before they're sent. Options include:

  • Send immediately -- the agent sends emails without waiting for approval.
  • Require approval -- emails go into a pending queue for you to review before they're dispatched.
warning

If your agent interacts with external contacts, start with Require approval enabled. This gives you a chance to review outgoing messages before they reach recipients. You can relax this once you're confident in your agent's email behavior.

5. View the inbox​

Switch to the Inbox view to see emails your agent has received. Each entry shows the sender, subject, and timestamp. Click on an email to see the full content and any actions the agent took in response (based on your inbound rules).

6. View the outbox​

The Outbox shows emails your agent has composed and is ready to send. If you have approval enabled, pending emails appear here waiting for your review.

For each pending email, you can:

  • Approve -- send the email as-is.
  • Reject -- discard the email without sending it.

7. Test your setup​

Send a test email to your agent's address (e.g., [email protected]) from your personal email account. Check the agent's Inbox to confirm the email was received and that your inbound rules triggered correctly.

8. Manage known contacts​

The Known Contacts section is an allowlist of approved email addresses for your agent. Contacts on this list can bypass certain rule conditions (such as auto-approving replies to known contacts). You can add contacts manually by clicking Add Contact and entering an email address, or contacts may be added automatically when the agent exchanges emails with new addresses.

9. Check the trash​

The Trash view shows deleted emails. If you accidentally reject an outbound email or delete an inbound one, you can find it here and restore it.

What you've done​

  • Located your agent's email address ([email protected])
  • Configured inbound rules for handling received emails
  • Set up outbound rules with approval controls
  • Reviewed the inbox, outbox, known contacts, and trash

Next steps​

Head to Create a Custom Workflow to build a visual workflow using Xircuits Studio.

See also