Step 1: Add Your Email Provider (SMTP Integration)
1. Go to the Integrations page from the main menu
Select SMTP Click Add Integration
3. Select SMTP as the integration type
4. Fill in the following fields:
Field | What to Enter | Example |
Integration Name | A label for your reference |
|
SMTP Host | Your email provider's server address | |
SMTP Port | Usually | 587 |
Username | Your email login |
|
Password | Your email password or app password | |
Default Sender Email | The "from" address your users will see |
|
Default Sender Name | The name that appears next to the email |
|
5. Click Save
Once saved, all authentication emails (login codes, password resets) will automatically be sent through your email provider.
Example: Set Up with Gmail / Google Workspace (Step-by-Step)
1. Go to (https://myaccount.google.com)
2. Click Security in the left sidebar
3. Scroll down to "How you sign in to Google"
4. Make sure 2-Step Verification is turned on (App Passwords won't work without it)
- If it's off, click it and follow the steps to enable it
5. Once 2-Step Verification is on, go back to the Security page
6. Search for "App Passwords" in the search bar at the top, or find it under the 2-Step Verification section
7. Click App Passwords
8. Under "Select app", type a name like AgentUI and click Create
9. Google will show you a 16-character password (looks like: abcd efgh ijkl mnop)
10. Copy this password immediately — you won't be able to see it again
Set Up with SendGrid (Step-by-Step)
1. Go to (https://sendgrid.com) and sign up for a free account
2. After signing in, go to Settings → API Keys (in the left sidebar)
3. Click Create API Key
4. Give it a name like AgentUI
5. Select Restricted Access, then enable:
- Mail Send → Full Access
6. Click Create & View
7. Copy the API key immediately — it starts with SG. and you won't be able to see it again
Part 2: Verify Your Sender Email
Before SendGrid will send emails on your behalf, you need to verify your sender address:
1. In SendGrid, go to Settings → Sender Authentication
2. You have two options:
- Single Sender Verification (quick, good for testing): Click Verify a Single Sender, fill in your email, and click the verification link SendGrid sends you
- Domain Authentication (recommended for production): Click Authenticate Your Domain, follow the steps to add DNS records to your domain — this ensures the best deliverability