Set up PocketBase mail settings over SMTP

PocketBase sends verification, password reset, email change and OTP emails, and by default hands them to the server's `sendmail` command. Switch it to SMTP under **Settings → Mail settings** in the dashboard; the values are stored with your app's settings, so there's no file to edit. The TLS choice sits under **Show more options**: **Auto (StartTLS)** is for 587 and **Always** is for 465.

Need an API key?

SMTP password is a Unitpost API key with emails:send. Username is always unitpost.

  • 5,000 emails/month
  • 3 API keys
  • 5 sending domains
Get free SMTP key
  1. Create a send-only key

    In Unitpost, open Settings → SMTP and create a send-only key. PocketBase's Sender address must be on a verified domain.

  2. Fill in Mail settings

    Turn on Use SMTP mail server, then click Show more options to reach the TLS setting.

    Sender nameYour app
    Sender addressno-reply@yourdomain.com
    SMTP server hostsmtp.unitpost.com
    Port587
    Usernameunitpost
    PasswordYour Unitpost API key
    TLS encryptionAuto (StartTLS)
    AUTH methodPLAIN (default)

    For port 465, set TLS encryption to Always.

  3. Save and send a test

    Click Save changes, then Send test email. Pick a template such as Password reset and an auth collection, enter a To email address and click Send. The message shows up in Unitpost Emails.

  4. If the test fails

    535 5.7.8 means Username isn't unitpost. 550 5.7.1 means Sender address isn't on a verified domain. A timeout on 465 means TLS encryption is still Auto (StartTLS).

Search docs and guides

Search the docs and product guides.