Skip to content

Create and send composable emails with Elixir and SendGrid.

License

Notifications You must be signed in to change notification settings

AgilionApps/sendgrid_elixir

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SendGrid

A wrapper for SendGrid's API to create composable emails.

Installation

Add the following code to your dependencies in your mix.exs file:

{:sendgrid, "~> 1.0.1"}

Configuration

In one of your configuration files, include your SendGrid API key like this:

config :sendgrid,
  api_key: "SENDGRID_API_KEY"

If you'd like to enable sandbox mode (emails won't send but will be validated), add the setting to your config:

config :sendgrid,
  api_key: "SENDGRID_API_KEY",
  sandbox_enable: true

Add :sendgrid to your list of applications

defp application do
  [applications: [:sendgrid]]
end

Usage

Check the docs for complete usage.

Simple Text Email

alias SendGrid.{Mailer, Email}

email = 
  Email.build()
  |> Email.put_from("[email protected]")
  |> Email.put_to("[email protected]")
  |> Email.put_subject("Hello From Elixir")
  |> Email.put_text("Sent from Elixir!")
  
Mailer.send(email)

Simple HTML Email

alias SendGrid.{Mailer, Email}

email = 
  Email.build()
  |> Email.put_from("[email protected]")
  |> Email.put_to("[email protected]")
  |> Email.put_subject("Hello From Elixir")
  |> Email.put_html("<html><body><p>Sent from Elixir!</p></body></html>")
  
Mailer.send(email)

Using a Predefined Template

alias SendGrid.{Mailer, Email}

email = 
  Email.build()
  |> Email.put_template("the_template_id")
  |> Email.add_substitution("-foo-", "bar")
  |> Email.put_html("<span>Some Text</span>")
  
Mailer.send(email)

About

Create and send composable emails with Elixir and SendGrid.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Elixir 100.0%