npm package: @objectif-lune/node-red-contrib-sendgrid
Description: Node-RED node to send email content generated by OL Connect using SendGrid service
Author: Upland Software Inc.
Latest version: 1.0.1

# Node-RED node to send email content generated by OL Connect technology using the SendGrid service

This `sendgrid` node sends pre-rendered email content, created by the `email content` node of the [OL Connect package for Node-RED](https://www.npmjs.com/package/@objectif-lune/node-red-contrib-connect), via the SendGrid service for bulk processing. This task uses SendGrid's v3 Web API which is faster than sending email over SMTP. 

## Features
- Sends pre-rendered email content, created by the `email content` node of the [OL Connect package for Node-RED](https://www.npmjs.com/package/@objectif-lune/node-red-contrib-connect).
- Tag emails with category names, which helps organize your email analytics.
- Batch multiple messages to optimize performance.
- Add custom headers specifying specific handling instructions for your email.
- Utilize SendGrid's sandbox mode to test an Email campaign before it is sent.
- Specify multiple replyTo addressees
- Send messages to a test address.

## Installation
Use the `Manage Palette` option from the `Node-RED`-menu, or run the following command in your Node-RED user directory - typically `~/.node-red`

```
npm install @objectif-lune/node-red-contrib-sendgrid
```

Obviously, you must have OL Connect installed on a server that can be reached from the one where Node-RED is installed, otherwise you won't be able to perform any automation tasks.

## Usage
This `sendgrid` node should be placed after the `email content` node of the [OL Connect package for Node-RED](https://www.npmjs.com/package/@objectif-lune/node-red-contrib-connect). The node takes its information from the `messages` array in `msg.payload`. This data could be modified and extended using a `function` node (for example to add static attachments).

To be able to send email using the node, you need a SendGrid account and an API key created in the [Settings](https://www.twilio.com/docs/sendgrid/api-reference/mail-send) section of the [SendGrid portal](https://app.sendgrid.com/settings/api_keys).

Rate limitations and restrictions apply to the number of Emails that can be added to a single batch, for more information see the [SendGrid documentation](https://docs.sendgrid.com/api-reference/mail-send/limitations).

Note also that this node requires you to specify the connection to the OL Connect Server.

## Support
OL Connect Automate is supported through the [OL Care program](https://uplandsoftware.com/objectiflune/customer-support-and-resources/). Feel free to visit the [OL Connect Automate forum](https://olforum.uplandsoftware.com/c/olcnrs/38) to post questions, comments and suggestions.

## License
Copyright 2025 Upland Software Inc.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.