Using Fastmail

Configure a Fastmail app password for Form email delivery

Fastmail requires an app-specific password when the Form component connects to its SMTP service. Do not enter the password used to sign in to Fastmail.

Sign up for a Fastmail account.

Fastmail Basic plans do not include SMTP access and cannot create app passwords. Use a plan that supports third-party email clients.

Create an App Password

1. Open Fastmail Settings → Privacy & Security.

Open the password and security settings.

1. Under Connected apps & API tokens, choose Manage app passwords and access, then New app password.

Create a separate credential for the Elements form.

1. Choose Custom, enter a recognisable name, give it Mail or SMTP access, and generate the password.

Limit the app password to SMTP access.

1. Copy the generated password. Fastmail may show it only once.

Store the generated password securely.

Configure Form

In Form → Settings:

1. Keep Type set to Email.
2. Set Host to smtp.fastmail.com, Port to 465, and Encryption to SSL. Alternatively, use Port 587 with TLS.
3. Enter the complete Fastmail email address as Username.
4. Paste the app-specific password into Password.
5. Use an address authorised by that Fastmail account as From Address.
6. Enter the recipient under To Address.

Use the app password rather than the normal account password.

Publish the site to a PHP-enabled server and complete a real submission. Forms cannot send from the normal local preview.

Troubleshooting

If authentication fails:

• Confirm that the app password was created for SMTP.
• Remove accidental spaces before or after Username and Password.
• Confirm the Host, Port, and Encryption values against Fastmail’s current server settings.
• Make sure From Address is permitted by the authenticated account.
• Generate a new app password if the original was revoked or lost.

For additional help, post the error and relevant non-sensitive log details on the Elements Forum. Never publish the app password.

Related Documentation

• Form — Configures email delivery and server checks.
• Submit — Adds the clickable control that sends the form.