Documentation Index
Fetch the complete documentation index at: https://docs.affzero.com/llms.txt
Use this file to discover all available pages before exploring further.
Overview
AffZero sends outbound emails using SMTP — you connect any email account that supports SMTP sending: Gmail, Google Workspace, Outlook, Yahoo, iCloud, or a custom mail server. Go to Providers → Email to add or manage your email accounts.Gmail users: if you also want to save files to Google Drive, use Google Doc invoice templates, or write to Google Sheets, connect via Gmail & GDrive instead. That one OAuth connection covers sending + all Google integrations at once. See Gmail & Google Drive.
Quick Setup — Pick Your Provider
In the Providers → Email form, click your provider’s button to pre-fill the SMTP host and port and reveal step-by-step instructions.Setting Up Gmail SMTP
Gmail requires an App Password — a 16-character code that lets AffZero send email on your behalf without using your main Google account password.Step 1 — Enable 2-Step Verification
App Passwords are only available when 2-Step Verification is turned on.- Go to your Google Account Security settings
- Under “How you sign in to Google”, click 2-Step Verification
- Follow the prompts to enable it if it isn’t already on
Google Workspace users: your admin may have already enforced 2-Step Verification. If the App Passwords option is missing, ask your admin to enable it for your account.
Step 2 — Create an App Password
- Go to myaccount.google.com/apppasswords (You must be signed in to the correct Google account)
- In the “App name” field, type something like
AffZeroso you can identify it later - Click Create
- Google shows a 16-character password (4 groups of 4 letters). Copy it now — Google won’t show it again
- Remove the spaces before pasting it into AffZero
Step 3 — Add the account in AffZero
- In AffZero, go to Providers → Email
- Click Add Gmail Account
- Fill in the form:
| Field | What to enter |
|---|---|
| Gmail Address | Your full Gmail or Workspace address (e.g. you@gmail.com or you@company.com) |
| App Password | The 16-character code from Step 2 (no spaces) |
| Sender Name | The display name recipients will see (e.g. Your Name or Your Company) |
- Click Add Gmail Account — AffZero encrypts the App Password (AES-256-GCM) and saves the account
Setting Up Outlook / Hotmail SMTP
| Field | Value |
|---|---|
| SMTP Host | smtp-mail.outlook.com |
| SMTP Port | 587 |
| Username | Your full Outlook address (e.g. you@outlook.com) |
| Password | Your Microsoft account password, or an App Password if 2FA is enabled |
Check SMTP AUTH is enabled
Sign in to Outlook.com → Settings → Mail → Sync email → confirm SMTP is allowed. Most accounts have it on by default.
Generate an App Password (if you use 2FA)
Go to account.microsoft.com/security → Advanced security options → App passwords → Create a new app password. Copy the generated password and use it in the SMTP Password field.
@outlook.com, @hotmail.com, and @live.com accounts.
Setting Up Yahoo Mail SMTP
| Field | Value |
|---|---|
| SMTP Host | smtp.mail.yahoo.com |
| SMTP Port | 587 |
| Username | Your full Yahoo address (e.g. you@yahoo.com) |
| Password | A Yahoo App Password — your regular password will not work |
Enable two-step verification
Go to login.yahoo.com/account/security and enable two-step verification if it isn’t already on.
Generate an App Password
On the same Security page, scroll to Generate app password, choose Other app, type
AffZero, and click Generate. Copy the password shown.Setting Up iCloud Mail SMTP
| Field | Value |
|---|---|
| SMTP Host | smtp.mail.me.com |
| SMTP Port | 587 |
| Username | Your Apple ID email (e.g. you@icloud.com) |
| Password | An app-specific password — your regular Apple ID password will not work |
Generate an app-specific password
Go to appleid.apple.com → sign in → Sign-In and Security → App-Specific Passwords → Generate an app-specific password. Name it
AffZero and copy the password shown.Custom SMTP Provider
For any other mail provider, select Custom and enter the details from your provider’s documentation:| Field | What to enter |
|---|---|
| SMTP Host | Your provider’s outbound SMTP server (e.g. mail.yourdomain.com) |
| SMTP Port | 587 for TLS/STARTTLS (recommended) or 465 for SSL |
| Username | Usually your full email address |
| Password | Your account password or an app-specific password if required |
Multiple Accounts
You can connect multiple Gmail accounts and choose which one to send from in each automation. This is useful when you want to send affiliate emails from one address and billing emails from another.| Plan | Gmail accounts |
|---|---|
| Starter | 1 |
| Pro | 2 |
| Pro+ | 3 |
| Business | 3 |
Email Forwarding (Receiving Emails)
In addition to sending emails, AffZero can receive emails via forwarding addresses. This is a separate feature used by the Email Received trigger — not for sending. Forwarding addresses look likeauto-7gk2p9xr@inbox.affzero.com. When you forward an email there (or set up automatic forwarding from your inbox), AffZero runs the automation linked to that address.
To set up forwarding:
- Go to Providers → Email Forwarding
- Create a forwarding address and give it a label (e.g. “Vendor invoices”)
- In your email client, forward messages to that address — manually or via an automatic rule
Troubleshooting
'Authentication failed' when saving the account
'Authentication failed' when saving the account
The most common causes:
- Gmail / Yahoo / iCloud: you used your regular account password instead of an App Password. These providers require an App Password for SMTP. Generate one and try again.
- Outlook: if 2FA is enabled, you need an App Password. If 2FA is off, your regular password should work — but make sure SMTP AUTH is enabled in your Outlook settings.
- Typo: re-paste the password carefully, removing any spaces.
- Wrong username: make sure the username is your full email address, not just the part before
@.
Email not delivered after saving
Email not delivered after saving
- Gmail: check that the App Password hasn’t been revoked. Go to Google Account → Security → App Passwords and verify the AffZero entry is still there.
- Outlook: verify SMTP AUTH is still enabled in Outlook settings.
- All providers: check your sending limits. Gmail personal accounts allow ~500 emails/day; Google Workspace up to 2,000/day. Yahoo and Outlook have similar per-day limits.
I don't see the App Passwords option in Gmail
I don't see the App Passwords option in Gmail
App Passwords only appear when 2-Step Verification is enabled on your Google account. If the option is missing even after enabling it, your Google Workspace admin may have restricted App Passwords — contact them and ask to enable it for your account.
Emails landing in spam
Emails landing in spam
SMTP via Gmail, Outlook, or Yahoo sends through those providers’ own infrastructure, so spam rates are generally low. If emails are landing in spam:
- Ask recipients to mark as “Not spam” and add your address to contacts
- Avoid spam trigger words in subject lines
- Make sure the sender name is recognisable
Does changing my account password break the connection?
Does changing my account password break the connection?
For Gmail, Yahoo, and iCloud — no, because you connected with an App Password which is independent of your main account password. If you revoke the App Password, you’ll need to generate a new one and update it in AffZero.For Outlook (without 2FA) — yes, if you use your regular password and change it, you’ll need to update the password in AffZero.