You are looking at historical revision 32653 of this page. It may differ significantly from its current revision.

Send Grid

Description

Provides a very simply api for sending email via SendGrid. The api uses SendGrid's web api. Currently only the sending of mail is supported, but other parts of the web api could be easily added.

Repository

https://github.com/ThomasHintz/chicken-scheme-send-grid

Author

Thomas Hintz

Contact me at t@thintz.com.

Requirements

List of Parameters

api-user

[parameter] (api-user user)

This is your SendGrid api user specified as a string.

api-key

[parameter] (api-key key)

This is your SendGrid api key specified as a string.

List of Procedures

send-mail

[procedure] (send-mail #!key (subject #f) (text #f) (html #f) (from #f) (from-name #f) (to #f) (reply-to #f) (api-user (api-user)) (api-key (api-key)) files)

Takes all the required arguments, passes a request on to SendGrid, and returns the SendGrid response in list form. api-user and api-key are optional if you specified them as parameters.

Only html or text needs to be specified. If html is specified, then the resulting email will be in HTML format. If both html and text are specified, then the resulting email will only include the contents of html.

files is optional and is a list of alists containing file attachments. The alist for each file must contain the key filename -- a string, filepath -- a string, and content-type -- a symbol. Example:

((filepath "/foo.txt") (filename "foo.txt") (content-type text/plain))

Example

(use send-grid)

(api-user "api-user")
(api-key "api-key")

(send-mail from: "example.from@example.org" to: "example.to@example.org" from-name: "Example Name" reply-to: "example-from@example.org" subject: "Example Subject" text: "Example text.")

Version History

Version 2.0.1

Add support for file attachments. (Thanks to Sven Hartrumpf)

Version 2

Fix some install bugs.

Version 1

Initial release.