This Apex Toolkit allows you to quickly and easily send emails through SendGrid using Salesforce Apex.
SendGrid sendgrid = new SendGrid('username', 'password');
SendGrid.email email = new SendGrid.Email();
email.addTo('foo@bar.com');
email.setFrom('me@bar.com');
email.setSubject('Subject goes here');
email.setText('Hello World!');
String response = sendgrid.send(email);To start using the SendGrid Apex Toolkit in your Salesforce Org, install the unmanaged package of the library with the following URL:
1.0: https://login.salesforce.com/packaging/installPackage.apexp?p0=04tF0000000SwjP
Click Continue -> Next -> Next -> Install.
To begin using this library, initialize the SendGrid object with your SendGrid credentials.
SendGrid sendgrid = new SendGrid('username', 'password');Add your message details.
SendGrid.email email = new SendGrid.Email();
email.addTo('foo@bar.com');
email.setFrom('me@bar.com');
email.setSubject('Subject goes here');
email.setText('Hello World!');
email.setHtml('<strong>Hello World!</strong>');Send it.
String response = sendgrid.send(email);SendGrid.email email = new SendGrid.Email();
email.addTo('email@example.com');
email.addTo('email2@example.com');SendGrid.email email = new SendGrid.Email();
List<String> tos = new List<String> { 'setTos@mailinator.com' };
email.setTos(tos);SendGrid.email email = new SendGrid.Email();
email.setFrom('foo@bar.com');SendGrid.email email = new SendGrid.Email();
email.setFromName('Example Lady');SendGrid.email email = new SendGrid.Email();
email.setReplyTo('foo@bar.com');Use multiple addTos as a superior alternative to setBcc.
SendGrid.email email = new SendGrid.Email();
email.addTo('foo@bar.com');
email.addTo('someotheraddress@bar.com');
email.addTo('another@another.com');
...But if you do still have a need for Bcc you can do the following.
SendGrid.email email = new SendGrid.Email();
email.addBcc('foo@bar.com');SendGrid.email email = new SendGrid.Email();
email.setSubject('This is a subject');SendGrid.email email = new SendGrid.Email();
email.setText('This is some text');SendGrid.email email = new SendGrid.Email();
email.setHtml('<h1>This is an html email</h1>');SendGrid.email email = new SendGrid.Email();
List<String> vals = new List<String> { 'val' };
email.addSubstitution('sub', vals);SendGrid.email email = new SendGrid.Email();
email.addUniqueArg('add_unique_argument_key', 'add_unique_argument_value');SendGrid.email email = new SendGrid.Email();
email.addCategory('Category 1');
email.addCategory('Category 2');SendGrid.email email = new SendGrid.Email();
email.addSection('set_section_key', 'set_section_value');SendGrid.email email = new SendGrid.Email();
email.addFtiler('footer', 'text/html', '<strong>boo</strong>');You can add standard email message headers as necessary.
SendGrid.email email = new SendGrid.Email();
email.addTo('foo@bar.com');
...
email.addHeader('X-Sent-Using', 'SendGrid-API');
email.addHeader('X-Transport', 'web');SendGrid.email email = new SendGrid.Email();
// as a string
email.addAttachmentStream('text.txt', 'somerandomcontentyouwant');
// as a blob
String text = 'This is an attachment.';
Blob as_blob = Blob.valueof(text);
email.addAttachmentStream('text.txt', as_blob);Getting your development environment setup to code on this project is difficult. The following explains how.
Create a salesforce.com developer account.
You'll receive an email from Salesforce with a link to confirm. Click it.
On the next screen, set your password. Yeah, it's an odd flow, but it's salesforce so what do you expect.
You now have a developer account.
Generate your security token. We will need this later. While logged into your developer account, click "Your Name > My Settings" at the top right portion of your developer account dashboard.
Then on the left side of the screen click "Personal > Reset My Security Token". Click the "Reset Security Token" button. Salesforce emails you a security token. You will need this later.
Open up Sublime Text 3, and then open up Mavens Mate on your machine. There should be a Mavens Mate icon, at the top bar of your screen. Click it and then click "Plugins".
On the next window, click "Install Plugin". This installs the Mavens Mate plugin into Sublime Text 3.
Close and reopen Sublime Text 3.
Click Mavens Mate > Settings > User at the top Sublime Text 3 Toolbar.
This will open a file called mavensmate.sublime-settings. Paste the following in that file. Adjust to the path and directory you want to store your salesforce code in. It must be an absolute path.
{
"mm_workspace": "/Users/your_username/code/salesforce"
}Save and close that file.
cd /Users/your_username/code/salesforce
git clone https://github.com/sendgrid/sendgrid-apex.git
With Sublime Text 3 still open, click "File > Open", and open the sendgrid-apex folder.
Right click on the sendgrid-apex containing folder, and choose "MavensMate > Create MavensMate Project".
On the next screen enter the following:
- For project name: 'sendgrid-apex'
- For username: enter your email address
- For password: enter your password APPENDED with your salesforce security token. (see above for how to generate the security token)
When you're ready click the 'Create Project' button.
This will create the project up on Salesforce.com and locally on your machine. That's what we want.
Next, the final and most important step.
Click "Mavens Mate > Project > Compile Project".
You're done!
Now go ahead and develop. I recommend this tutorial or this blog post for learning some basics of developing with Apex.
Search for "packages".
Click "Create > Packages".
Click "New" under Packages.
Name the package "sendgrid-apex" and click save.
On the list of packages screen, now click "sendgrid-apex".
On the next screen under components, click "Add".
On the next screeen choose "Apex Class" under Component Type.
Check all the SendGrid related classes.
Then click "Add to Package".
Then click "Add" again.
This time on the next screen choose "Remote Site".
Check the SendGrid Remote Site, and click "Add to Package".
Then on the package show page, click "Upload".
On the next screen, enter "052114-sendgrid-apex" for the name (change the mm/dd/yy to the current).
Set version number to 1.0.
Set the description to: "This Apex Toolkit allows you to quickly and easily send emails through SendGrid using Salesforce Apex."
Scroll down to the very bottom and click "Upload".
Copy and paste the installation url and place in the README.
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Added some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request