Phoenix

The mailblastr SDK is for Node.js — Elixir users send email by POSTing JSON to https://api.mailblastr.com/emails. The example below uses `Req`, a batteries-included HTTP client, called from a Phoenix controller. HTTPoison works the same way if you already have it.

Prerequisites

Before you start, you will need:

• A MailBlastr API key.
• A verified domain to send from.
• A Phoenix application.

1. Install an HTTP client

Add req to your list of dependencies in mix.exs, then run mix deps.get.

def deps do
  [
    {:req, "~> 0.5"}
  ]
end

2. Set your API key

Read the API key from the environment rather than hardcoding it. In runtime.exs you can put it into your app config, then read it back where you send.

config :my_app, :mailblastr_api_key, System.fetch_env!("MAILBLASTR_API_KEY")

3. Send email from a controller

POST the email body to the MailBlastr API from a controller action. The easiest way to send is with the html field.

defmodule MyAppWeb.EmailController do
  use MyAppWeb, :controller

  def send(conn, _params) do
    api_key = Application.fetch_env!(:my_app, :mailblastr_api_key)

    response =
      Req.post!("https://api.mailblastr.com/emails",
        auth: {:bearer, api_key},
        json: %{
          from: "Acme <onboarding@yourdomain.com>",
          to: ["delivered@example.com"],
          subject: "hello world",
          html: "<strong>it works!</strong>"
        }
      )

    json(conn, %{id: response.body["id"]})
  end
end