Send Email from Elixir with the turboSMTP Swoosh Adapter

Status: Available from Swoosh 1.28.0. Swoosh.Adapters.TurboSMTP sends email and attachments through the turboSMTP HTTP API. It supports Global and EU endpoints, provider options, and automatic inline-CID qualification. See the published package.

Install

Add {:swoosh, "~> 1.28"} to your Mix dependencies and run mix deps.get. Configure an API client supported by Swoosh, such as Req, Finch, or Hackney.

Configure the mailer

Add the adapter to your mailer config and load your Consumer Key and Consumer Secret from environment variables.

config :sample, Sample.Mailer,
  adapter: Swoosh.Adapters.TurboSMTP,
  consumer_key: System.fetch_env!("TURBOSMTP_CONSUMER_KEY"),
  consumer_secret: System.fetch_env!("TURBOSMTP_CONSUMER_SECRET")

config :sample, Sample.Mailer,
  adapter: Swoosh.Adapters.TurboSMTP,
  consumer_key: System.fetch_env!("TURBOSMTP_CONSUMER_KEY"),
  consumer_secret: System.fetch_env!("TURBOSMTP_CONSUMER_SECRET"),
  base_url: "https://api.eu.turbo-smtp.com/api/v2"

Place the chosen configuration in config/runtime.exs. The default Global base URL is https://api.turbo-smtp.com/api/v2. Define your mailer if you do not already have one:

lib/sample/mailer.ex

defmodule Sample.Mailer do
  use Swoosh.Mailer, otp_app: :sample
end

Set base_url to https://api.eu.turbo-smtp.com/api/v2 to send through turboSMTP’s European servers. See GDPR and data residency.

Send the first message

import Swoosh.Email

new()
|> from("noreply@your-domain.example")
|> to("developer@example.com")
|> subject("Hello from Elixir")
|> text_body("The TurboSMTP adapter is working.")
|> Sample.Mailer.deliver()

Resources

Adapter Documentation

Full reference for Swoosh.Adapters.TurboSMTP on HexDocs.

Merged Pull Request

The Swoosh pull request that added the turboSMTP adapter.

⌘I

Overview

Frameworks & Libraries

Apps & Platforms

Send Email from Elixir with the turboSMTP Swoosh Adapter

Install

Configure the mailer

Send the first message

Resources

Adapter Documentation

Merged Pull Request

​Install

​Configure the mailer

​Send the first message

​Resources

Adapter Documentation

Merged Pull Request

Install

Configure the mailer

Send the first message

Resources