A Clojure library for sending emails with SendGrid.

Usage

(require '[sendgrid.core :as sendgrid])
(def sg-config
  {:api-key "d34db33f"})
;; Send a plain-text email
(sendgrid/send-email sg-config
                     {:to      "email@example.com"
                      :from    "email2@example.com"
                      :subject "SendGrid Test"
                      :text    "Email body here."})
;; => {:message "success"}
;; Send an HTML email
(sendgrid/send-email sg-config
                     {:to      "email@example.com"
                      :from    "email2@example.com"
                      :subject "SendGrid Test"
                      :html    "<h1>Email body here.</h1>"})
;; => {:message "success"}

For details on individual request params, please see the SendGrid API documentation.

Emails can also include attachments via the :attachments param. Attachments must be a sequence of maps where each map contains a :name and :content and optionally a :mime-type (String). :content can be a File, InputStream, ByteArray, or String.

(let [attachments
      [{:name "plain.txt", :mime-type "text/plain", :content "Simple."}
       {:name "yay.jpg",   :content (-> "yay.jpg" io/resource io/file)}]]
  (sendgrid/send-email sg-config
                       {:to          "email@example.com"
                        :from        "email2@example.com"
                        :subject     "SendGrid Test"
                        :html        "<h1>Email body here.</h1>"
                        :attachments attachments}))
;; => {:message "success"}

Testing

To run the tests you'll need the following environment variables set:

SENDGRID_API_KEY
FROM_EMAIL
TO_EMAIL

Alternately you can set these values in a profiles.clj file (see Environ for more information).

Please note that the tests will send real emails to the TO_EMAIL you've set, and will count against your SendGrid email quota.

Motivation

Features differentiating this library from (some of) the alternatives:

Idiomatic Clojure.
No global state.
Convenient handling of files (whether generated or served from the file system).
No errors on long message contents.
No assumptions about error handling (error handling is caller's responsibility).

License

Distributed under the MIT License.