3 Sending Email

1. Using any controller's built-in sendMail method, and passing your email details to it.

> Note: This is the grails-mail way of doing things, and should always be your preferred method to allow for quick and easy interchange of any grails-supported mail plugin.

sendMail {
     from 'antony@example.com'
     to 'aiten@example.net'
     to 'wirah@example.org'
     bcc 'yourbcc@example.com'
     subject 'This is the subject line'
     body 'This is our message body'
}

2. Using the sendMail closure from any class which has a reference to the SendGridService.

As above, but referencing the sendMail method of the SendGridService directly:

sendGridService.sendMail {
    …
}

3. Using the email builder

This is useful when you might want a more programmatic approach to sending email.

SendGridEmail email = new SendGridEmailBuilder()
                        .from('antony@example.com')
                        .to('aiten@example.net')
                        .subject('This is the subject line')
                        .withText('This is our message body')
                        .build()

When you've built your email, pass it to the SendGridService's send method:

sendGridService.send(email)

The email builder is written as a natural-language type DSL, so you might find that there is more than one way to build your email, but under the covers, they are exactly the same.

4. Optional email parameters and advanced sending instructions

.to('email@example.com')

to 'email@example.com'

.to('Antony Jones', 'email@example.com')

.addRecipient('Antony Jones', 'email@example.com')

.from('email@example.com')

from 'email@example.com'

.from('Antony Jones', 'emailexample.com')

.replyTo('email@example.com')

replyTo 'email@example.com'

.sentDate(new Date())

sentDate new Date()

.subject('Your subject line')

subject 'Your subject line'

.addBcc('email@example.com')

bcc 'email@example.com'

.text('Your message text')

body 'Your message text'

.html('<h2>Your message html</h2>')

html '<h2>Your message html</h2>'

.addCustomHandlingInstruction('headerName', 'headerValue')

addCustomHandlingInstruction 'headerName', 'headerValue'

.addHeader('headerName', 'headerValue')

addHeader 'headerName', 'headerValue'

.addAttachment(new File('/tmp/your.file'))

attach new File('/tmp/your.file')

For further details, see the sendgrid api