Skip to main content

Mail (SMTP)

Lets an agent send emails from an SMTP mailbox you control.

What it can do​

  • Send plain-text, HTML, or both (multipart/alternative fallback)
  • CC, BCC, Reply-To
  • Custom sender name

How to get credentials​

You'll need SMTP server details and an authentication credential for a mailbox you can send from. Examples:

  • Gmail / Google Workspace: SMTP host smtp.gmail.com, port 587, username = your full email, password = an App Password (myaccount.google.com/apppasswords). Requires 2-Step Verification enabled.
  • Outlook / Microsoft 365: smtp.office365.com, port 587, username = your email, password = an app password (if your tenant requires modern auth, SMTP Auth must be enabled by the admin).
  • Transactional providers (SendGrid, Postmark, Mailgun, SES) — create an SMTP credential in the provider's dashboard. For SendGrid the username is literally apikey and the password is the API key.

Fields to fill in FlyMyAI​

FlyMyAI fieldWhere it comes from
SMTP_HOSTYour provider, e.g. smtp.gmail.com
SMTP_PORTUsually 587 (STARTTLS) or 465 (SSL)
SMTP_USERUsername — typically your email, or apikey for SendGrid
SMTP_PASSWORDApp password or API key
MAIL_FROMDefault From: address

Troubleshooting​

  • SMTPAuthenticationError — for Gmail/Workspace, generate an App Password; regular account passwords don't work with SMTP.
  • Messages land in spam — set up SPF, DKIM, and DMARC on the sending domain. Use a transactional provider with a verified domain for volume.
  • Port blocked — some networks block 465/587. Try the other port.