Mail Account Settings

The Mail Account Settings page allows you to view and manage all the email accounts connected to Helm

Setting up your Mail Accounts

The Mail Account Settings page allows you to view and manage the email accounts connected to your Helm platform. By default, Helm includes its own built-in mail account, which is responsible for sending standard system emails such as notifications, updates, and alerts

For greater flexibility, you can connect third-party providers such as Brevo, Mailgun, or Amazon SES. This gives you enhanced control over deliverability, branding, and sender reputation-ensuring that your communications reach your customers reliably and with a professional touch

Managing Mail Accounts

On this page, you will see:

  • Helm Mail Account – the default system mail account (pre-configured)

  • Third-Party Mail Accounts – optional external providers you can add for outbound mail

Connecting an external provider is optional but highly recommended if you wish to optimise email performance and branding

Adding a New Mail Account

  1. Click Create New Mail Account

  2. Select your preferred provider (Brevo, Mailgun, or Amazon SES)

  3. Enter the required details for your chosen provider

  4. Save and test your configuration before going live

Brevo

Steps to Get Your Brevo API Key

  1. Log in to Brevo
    Go to https://app.brevo.com and sign in

  2. Go to SMTP & API section

    • Click your profile picture (top right)

    • Select SMTP & API from the dropdown

  3. Find or create your API key

    • On the API Keys tab, you’ll see any existing keys

    • If you don’t have one yet, click Generate a New API Key

    • Give it a name (e.g. My App Integration) so you know what it’s used for

  4. Copy your API key

    • Once generated, you’ll see the key only once

    • Copy it immediately and store it securely in your environment variables or secret manager

  5. Use the key in your app

    • Brevo’s API requires this key in the request headers:

⚠️ Best practice:

  • Don’t share your API key publicly

  • Use separate keys for different environments (e.g. dev, staging, production)

  • Rotate or revoke old keys if you think they’re exposed

Add Brevo Account

  • Name – Enter a recognisable name (e.g. Brevo – Main Notifications)

  • Brevo Key – Enter your API key

    • Found in SMTP & API → API Keys within your Brevo account

    • Generate a new key if needed

  • Test Sender – Add a test email address for verifying the connection

  • Click Complete Setup to finalise the integration

📌 Tip: Always send a test email before switching to live use

Mailgun

Steps to Find Your Mailgun API Key

To find your API key in Mailgun, navigate to the Account Settings and select the API Keys section. You'll be able to manage and regenerate your keys there. For more detailed guidance, check out the Mailgun Help Center

  1. Go to https://app.mailgun.com and sign in

    1. For your Mailgun domain → Navigate to Send > Sending > Domains and copy your domain name

    2. For creation API key → Click your account dropdown, select API Security, and create a new API key

    3. Your region → Check the top navigation bar to confirm if you’re in the EU or US region

  2. Copy your key

    • Click the eye icon to reveal the key

    • Copy it safely to your environment variables or secret manager

  3. (Optional: Regenerate your key)

    • If you think your API key has been exposed, you can click Generate new key

    • Remember to update all apps/services using the old key

For more detailed guidance, check out the Mailgun Help Center

For any technical support questions, please reach out through our support contact page


Add or Edit Mailgun Account

  • Name – Enter a clear identifier (e.g. Mailgun Test Account)

  • Mailgun API Key – Paste your Mailgun API key

  • Mailgun Domain – Enter the domain configured in Mailgun

  • Mailgun API Base URL – Enter your account’s base API URL

  • Test Sender – Add a test email address for verification

  • Click Test Sender to confirm the connection

Amazon SES

Steps to Get Your Amazon SES API Credentials

  1. Log in to AWS Management Console
    Go to https://console.aws.amazon.com/

  2. Navigate to IAM (Identity and Access Management)

    • Search for IAM in the search bar

    • Open the IAM Dashboard

  3. Create a new IAM user (recommended for SES access only)

    • Click Users > Add users

    • Give the user a name (e.g. ses-smtp-user)

    • Select Programmatic access (this is what generates API keys)

  4. Assign permissions

    • Attach an existing policy directly

    • Choose AmazonSESFullAccess (or better, create a more restricted custom policy)

  5. Finish user creation

    • After you create the user, you’ll see Access Key ID and Secret Access Key

    • Download the .csv file or copy the credentials somewhere safe (you won’t be able to see the Secret Key again later)

  6. (Optional: For SMTP)
    If you plan to send email through SES’s SMTP endpoint instead of the API:

    • Go to SES Console > SMTP settings

    • Click Create SMTP credentials

    • This generates an SMTP username & password (which is actually a transformed IAM access key)

  7. Use the credentials in your app

    • For API (AWS SDKs): use Access Key ID and Secret Access Key

    • For SMTP: use SMTP username and SMTP password with SES’s SMTP endpoint

⚠️ Best Practice:

  • Don’t use your root account keys. Always create an IAM user

  • Restrict permissions to SES only if that’s all the user needs

  • Store keys securely (e.g. environment variables, AWS Secrets Manager)

Add or Edit Amazon SES Account

  • Name – Enter a recognisable identifier (e.g. Amazon SES – Production)

  • Region – Enter your SES region (e.g. eu-west-1)

  • Key – Enter your Amazon SES access key

  • Secret – Enter your Amazon SES secret key

  • Test Sender – Enter an email address for testing

  • Click Test Sender to verify your account

Once your mail accounts are configured, Helm will use them to send outbound system messages such as order updates, notifications, and alerts. The flexibility of adding providers like Brevo, Mailgun, or Amazon SES ensures your business maintains reliable email delivery and a professional brand presence

With the right configuration, you can confidently send communications knowing they will reach your customers securely and without interruption

For further help, contact Helm Support