loopback-connector-sendgrid

# loopback-connector-sendgrid [![view on npm](http://img.shields.io/npm/v/loopback-connector-sendgrid.svg?style=flat)](https://www.npmjs.org/package/loopback-connector-sendgrid) [![npm module downloads per month](http://img.shields.io/npm/dm/loopback-connector-sendgrid.svg?style=flat)](https://www.npmjs.org/package/loopback-connector-sendgrid) [![Dependency status](https://david-dm.org/Cellarise/loopback-connector-sendgrid.svg?style=flat)](https://david-dm.org/Cellarise/loopback-connector-sendgrid) [![Build Status](https://travis-ci.org/Cellarise/loopback-connector-sendgrid.svg?branch=master)](https://travis-ci.org/Cellarise/loopback-connector-sendgrid) [![Code Climate](https://codeclimate.com/github/Cellarise/loopback-connector-sendgrid/badges/gpa.svg)](https://codeclimate.com/github/Cellarise/loopback-connector-sendgrid) [![Test Coverage](https://codeclimate.com/github/Cellarise/loopback-connector-sendgrid/badges/coverage.svg)](https://codeclimate.com/github/Cellarise/loopback-connector-sendgrid/badges/coverage.svg) > Loopback connector module which allow to send emails via SendGrid ## Installation ````sh npm install loopback-connector-sendgrid --save ```` ## Configuration ### Sendgrid API key Use the following configuration if you have an api key. datasources.json { "sendgrid": { "connector": "loopback-connector-sendgrid", "api_key": '[your api key here]' } } model-config.json { "Email": { "dataSource": "sendgrid", "public": false } } Configuration in JavaScript var DataSource = require('loopback-datasource-juggler').DataSource; var dsSendGrid = new DataSource('loopback-connector-sendgrid', { api_key: '[your api key here]' }); loopback.Email.attachTo(dsSendGrid); ### Sendgrid settings Using sendgrid mail_settings and tracking_settings: datasources.json { "sendgrid": { "connector": "loopback-connector-sendgrid", "api_key": '[your api key here]', "mail_settings": {[your mail_settings JSON object]}, "tracking_settings": {[your tracking_settings JSON object]} } } ## Usage Basic option same as built in Loopback: loopback.Email.send({ to: "test@to.com", from: "test@from.com", subject: "subject", text: "text message", html: "html message" }, function(err, result) { if(err) { console.log('Upppss something crash'); return; } console.log(result); }); Advanced options using the sendGridConfig option: loopback.Email.send({ to: "test@to.com", from: "test@from.com", subject: "subject", text: "text message", html: "html message", sendGridConfig: { personalizations: ..., template_id: ..., sections: ..., headers: ..., categories: ..., custom_args: ..., send_at: ..., batch_id: ..., asm: ..., ip_pool_name: ..., reply_to: ... } }, function(err, result) { if(err) { console.log('Upppss something crash'); return; } console.log(result); }); ## API *documented by [jsdoc-to-markdown](https://github.com/75lb/jsdoc-to-markdown)*. # Changelog <table style="width:100%;border-spacing:0px;border-collapse:collapse;margin:0px;padding:0px;border-width:0px;"> <tr> <th style="width:20px;text-align:center;"></th> <th style="width:80px;text-align:center;">Type</th> <th style="width:80px;text-align:left;">ID</th> <th style="text-align:left;">Summary</th> </tr> <tr> <td colspan=4>Version: 2.0.1 - released 2016-07-08</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10403&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Bug</td> <td style="width:80px;text-align:left;">MDLPCNSG-30</td> <td>Package: Fix library to use sendgrid web APIv3 configuration</td> </tr> <tr> <td colspan=4>Version: 2.0.0 - released 2016-07-08</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10418&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Non-functional</td> <td style="width:80px;text-align:left;">MDLPCNSG-29</td> <td>Package: Move babel-core from dependencies to devDependencies</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10418&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Non-functional</td> <td style="width:80px;text-align:left;">MDLPCNSG-28</td> <td>Package: Upgrade Sendgrid dependency from ^2.0.0 to ^3.0.4 (upgraded in version 1.2.4)</td> </tr> <tr> <td colspan=4>Version: 1.2.4 - released 2016-07-07</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10418&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Non-functional</td> <td style="width:80px;text-align:left;">MDLPCNSG-24</td> <td>Package: update usage documentation to describe configuration of sendgrid api key</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10403&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Bug</td> <td style="width:80px;text-align:left;">MDLPCNSG-27</td> <td>Email connector: Fix filters reference to higher scoped var sendgridFilters</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10418&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Non-functional</td> <td style="width:80px;text-align:left;">MDLPCNSG-26</td> <td>Package: Update package dependencies</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10418&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Non-functional</td> <td style="width:80px;text-align:left;">MDLPCNSG-25</td> <td>Package: Update package dependencies</td> </tr> <tr> <td colspan=4>Version: 1.2.3 - released 2016-02-16</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10418&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Non-functional</td> <td style="width:80px;text-align:left;">MDLPCNSG-23</td> <td>Package: Update package dependencies</td> </tr> <tr> <td colspan=4>Version: 1.2.2 - released 2015-11-26</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10418&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Non-functional</td> <td style="width:80px;text-align:left;">MDLPCNSG-22</td> <td>Package: Update package dependencies</td> </tr> <tr> <td colspan=4>Version: 1.2.0 - released 2015-10-05</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10411&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Feature</td> <td style="width:80px;text-align:left;">MDLPCNSG-16</td> <td>Email connector: Add support for api_key</td> </tr> <tr> <td colspan=4>Version: 1.1.4 - released 2015-08-25</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10418&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Non-functional</td> <td style="width:80px;text-align:left;">MDLPCNSG-15</td> <td>Package: Update development dependencies and configure for travis-ci</td> </tr> <tr> <td colspan=4>Version: 1.1.3 - released 2015-07-21</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10418&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Non-functional</td> <td style="width:80px;text-align:left;">MDLPCNSG-14</td> <td>Package: Update package dependencies</td> </tr> <tr> <td colspan=4>Version: 1.1.2 - released 2015-07-14</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10418&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Non-functional</td> <td style="width:80px;text-align:left;">MDLPCNSG-13</td> <td>Package: Update package dependencies</td> </tr> <tr> <td colspan=4>Version: 1.1.1 - released 2015-07-01</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10418&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Non-functional</td> <td style="width:80px;text-align:left;">MDLPCNSG-12</td> <td>Package: Update package dependencies</td> </tr> <tr> <td colspan=4>Version: 1.1.0 - released 2015-06-30</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10403&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Bug</td> <td style="width:80px;text-align:left;">MDLPCNSG-11</td> <td>Email connector: From address specification mismatch</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10411&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Feature</td> <td style="width:80px;text-align:left;">MDLPCNSG-10</td> <td>Email connector: Send message attachments</td> </tr> <tr> <td colspan=4>Version: 1.0.3 - released 2015-04-20</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10418&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Non-functional</td> <td style="width:80px;text-align:left;">MDLPCNSG-9</td> <td>Package: Update package dependencies</td> </tr> <tr> <td colspan=4>Version: 1.0.2 - released 2015-02-23</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10418&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Non-functional</td> <td style="width:80px;text-align:left;">MDLPCNSG-8</td> <td>Package: Update package dependencies</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10418&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Non-functional</td> <td style="width:80px;text-align:left;">MDLPCNSG-7</td> <td>Package: Update eslint configuration, test.js runner and dev dependencies</td> </tr> <tr> <td colspan=4>Version: 1.0.1 - released 2015-02-03</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10403&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Bug</td> <td style="width:80px;text-align:left;">MDLPCNSG-6</td> <td>Email connector: Email subject line not set</td> </tr> <tr> <td colspan=4>Version: 1.0.0 - released 2015-02-03</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10411&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Feature</td> <td style="width:80px;text-align:left;">MDLPCNSG-5</td> <td>Email connector: Add sendgrid filters passthrough from datasource</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10411&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Feature</td> <td style="width:80px;text-align:left;">MDLPCNSG-4</td> <td>Email connector: Add sendgrid options passthrough from datasource</td> </tr> <tr> <td colspan=4>Version: 0.1.1 - released 2015-02-03</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10418&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Non-functional</td> <td style="width:80px;text-align:left;">MDLPCNSG-3</td> <td>Package: Update package dependencies</td> </tr> <tr> <td colspan=4>Version: 0.1.0 - released 2015-02-02</td> </tr> <tr> <td style="width:20px;padding:0;margin:0;text-align:center;"><img src="https://jira.nhvr.net:80/secure/viewavatar?size=xsmall&avatarId=10411&avatarType=issuetype"/></td> <td style="width:80px;text-align:left;">Feature</td> <td style="width:80px;text-align:left;">MDLPCNSG-2</td> <td>Email connector: Add a loopback connector for sending emails from SendGrid</td> </tr> </table> # License MIT License (MIT). All rights not explicitly granted in the license are reserved. Copyright (c) 2015 John Barry ## Dependencies [loopback-connector-sendgrid@0.0.0]("https://github.com/Cellarise/loopback-connector-sendgrid") - "MIT License (MIT)", *documented by [npm-licenses](http://github.com/AceMetrix/npm-license.git)*.