Skip to content

using-fastmail.md

Latest commit

 

History

History
65 lines (41 loc) · 3.36 KB

using-fastmail.md

File metadata and controls

65 lines (41 loc) · 3.36 KB
Raw
description Configure a Fastmail app password for Form email delivery

Using Fastmail

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.

{% hint style="info" %} Sign up for a Fastmail account. {% endhint %}

{% hint style="warning" %} Fastmail Basic plans do not include SMTP access and cannot create app passwords. Use a plan that supports third-party email clients. {% endhint %}

Create an App Password

  1. Open Fastmail Settings → Privacy & Security.

Fastmail settings showing password and security options

Open the password and security settings.

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

The New App Password option in Fastmail

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.

Creating a custom SMTP app password in Fastmail

Limit the app password to SMTP access.

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

A generated Fastmail app password ready to copy

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.

Fastmail SMTP details entered in the Elements Form component

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.