# Sendgrid

The Sendgrid service allows you to send automated emails from your app using the [Twilio Sendgrid API](https://sendgrid.com/). *** ## Profile Settings {% hint style="success" %} NOTE: All profile settings are encrypted and stored in Zingy's cloud infrastructure. {% endhint %} ### API Key

Enter your [Sendgrid API Key here](https://docs.sendgrid.com/ui/account-and-settings/api-keys). *** ## Connection Settings {% hint style="success" %} NOTE: All connection settings are encrypted and stored in Zingy's cloud infrastructure. {% endhint %} ### From Address

Enter the from address to use when sending the email using this connection. *** ## Operations/Commands The [Execute Connection Command](https://docs.zingy.ai/app-editor/page-flow/toolbox-blocks/execute-connection-command) block is available in both [Page Flow](https://docs.zingy.ai/app-editor/page-flow) and [Cloud Flow](https://docs.zingy.ai/app-editor/cloud-flow). Using this block you can add logic to trigger the operations/commands supported by the Sendgrid service. {% hint style="success" %} For security purposes, all operations/commands offered by the Sendgrid service are only available in [Cloud Flow](https://docs.zingy.ai/app-editor/cloud-flow) and cannot be used in [Page Flow](https://docs.zingy.ai/app-editor/page-flow). {% endhint %} ### Send Email (Plain Text) Use this command to send a plain-text email using the Sendgrid service. #### Input Data When invoking this operation, an object with the following properties is required:

Property	Type	Description
toAddr	text or list	One or more recipient email addresses. For multiple addresses use a list.
ccAddr	text or list	Optional. One or more CC email addresses. For multiple addresses use a list.
bccAddr	text or list	Optional. One or more BCC email addresses. For multiple addresses use a list.
subject	text	The subject for the email.
msg	text	The email's message or body.
customProps	object	Optional. For advanced users, this specifies an object with properties based on parameters used by the Sendgrid API.

#### Output The Send Email (Plain Text) command does not provide any output beyond the Success/Fail status. ### Send Email (HTML) Use this command to send an email in HTML format using the Sendgrid service. #### Input Data When invoking this operation, an object with the following properties is required:

Property	Type	Description
toAddr	text or list	One or more recipient email addresses. For multiple addresses use a list.
ccAddr	text or list	Optional. One or more CC email addresses. For multiple addresses use a list.
bccAddr	text or list	Optional. One or more BCC email addresses. For multiple addresses use a list.
subject	text	The subject for the email.
msg	text	The email's message or body in HTML format.
msgText	text	The email's message or body in text format. Used for cases where the recipient's email client is unable to show the HTML formatted message.
customProps	object	Optional. For advanced users, this specifies an object with properties based on parameters used by the Sendgrid API.

#### Output The Send Email (HTML) command does not provide any output beyond the Success/Fail status. ### Send Email (Template) Use this command to send an email using a pre-defined template in your Sendgrid account. #### Input Data When invoking this operation, an object with the following properties is required:

Property	Type	Description
toAddr	text or list	One or more recipient email addresses. For multiple addresses use a list.
ccAddr	text or list	Optional. One or more CC email addresses. For multiple addresses use a list.
bccAddr	text or list	Optional. One or more BCC email addresses. For multiple addresses use a list.
subject	text	The subject for the email.
templateId	text	The identifier of the Sendgrid template.
substitutions	object	Object containing dynamic dynamic substitutions.
substitutionWrappers	list	Optional. Defaults to {{ and }}. A list containing the starting and ending wrappers for identifying substitution properties.
customProps	object	Optional. For advanced users, this specifies an object with properties based on parameters used by the Sendgrid API.

#### Output The Send Email (Template) command does not provide any output beyond the Success/Fail status. *** ## Advanced Functionality In your app's Cloud Flow Web Hooks and Background Tasks, the [Custom Code](https://docs.zingy.ai/app-editor/page-flow/toolbox-blocks/custom-code) block can be used to access and implement advanced functionality related to the Sendgrid email service. To access the client initialized with credentials saved on this Sendgrid service connection, see the following example: ```javascript // To use a sendgrid client initialized with credentials // provided in a Sendgrid connection const sgMail = zingyConn.sendgrid(connectionName); ``` You may also initialize a separate Sendgrid client, by specifying account credentials directly: ```javascript const sgMail = require('@sendgrid/mail'); sgMail.setApiKey(apiKey); ``` After the `sgMail` object is initialized, you can use it to call into the [Sendgrid library](https://www.npmjs.com/package/@sendgrid/mail). If you need to utilize Sendgrid API beyond simply sending emails, please see [@sendgrid/client](https://docs.zingy.ai/cloud-flow/sdk-library-integration#sendgrid-client) .