Transmitly Elixir SDK
Elixir client for the Transmitly API.
# mix.exs — from the platform repository
{:transmitly, path: "sdk/elixir"}
tx = Transmitly.Client.new(System.fetch_env!("TRANSMITLY_API_KEY"))
accepted =
Transmitly.Client.send_email(tx, %{
"from" => "Notify <notify@mail.acme.com>",
"to" => ["ada@example.net"],
"subject" => "Your workspace is ready",
"html" => "<p>Welcome.</p>",
"reply_to" => "Support <support@acme.com>",
"tags" => %{"flow" => "onboarding"}
})
send_email/3 generates an idempotency key. Pass idempotency_key: to control
it yourself; retries with the same key return the original message.
Phoenix
# config/runtime.exs
config :my_app, :transmitly,
api_key: System.fetch_env!("TRANSMITLY_API_KEY")
# lib/my_app/mailer.ex
defmodule MyApp.Mailer do
def welcome(user) do
tx = Transmitly.Client.new(Application.fetch_env!(:my_app, :transmitly)[:api_key])
Transmitly.Client.send_email(tx, %{
"from" => "Notify <notify@mail.acme.com>",
"to" => [user.email],
"subject" => "Welcome to Acme",
"html" => "<p>Your workspace is ready.</p>"
})
end
end
Resources
Transmitly.Client.get_email(tx, message_id)
Transmitly.Client.list_messages(tx, status: "bounced", limit: 20)
Transmitly.Client.deliveries(tx, message_id)
Transmitly.Client.list_domains(tx)
Transmitly.Client.create_domain(tx, "mail.acme.com")
Transmitly.Client.verify_domain(tx, domain_id)
Transmitly.Client.list_suppressions(tx)
Transmitly.Client.add_suppression(tx, %{"email" => "bounce@example.net", "reason" => "manual"})
Transmitly.Client.list_webhooks(tx)
Transmitly.Client.create_webhook(tx, %{"url" => "https://api.acme.com/hooks", "events" => ["email.delivered_to_mx"]})
Transmitly.Client.inbound_routes(tx)
Transmitly.Client.usage(tx)
Transmitly.Client.events(tx, limit: 50)
Transmitly.Client.health(tx)
Non-2xx responses raise Transmitly.Error with status, code, message,
details and payload.
Webhooks
def create(conn, _params) do
{:ok, raw, conn} = Plug.Conn.read_body(conn)
signature = Plug.Conn.get_req_header(conn, "transmitly-signature") |> List.first()
secret = System.fetch_env!("TRANSMITLY_WEBHOOK_SECRET")
if Transmitly.verify_webhook(raw, signature, secret) do
# Parse and handle only after the signature passes.
send_resp(conn, 200, "ok")
else
send_resp(conn, 400, "bad signature")
end
end
Domain, webhook and inbound management require an API key with the admin
scope.
mix deps.get
mix test
mix hex.build