SendGrid Connector

SendGrid is a cloud-based email delivery platform owned by Twilio. This component allows you to send transactional and marketing emails, manage contacts, and track email analytics.

API Documentation

This component was built using the SendGrid API v3.

Connections

SendGrid API Key

Authenticate requests to SendGrid using values obtained from the SendGrid Developer Console.

To authenticate with SendGrid, an API key is required.

Setup Steps

To generate an API key:

1. Log in to the SendGrid Console
2. Navigate to Settings > API Keys
3. Click Create API Key
4. Enter a name for the API key
5. Select the appropriate access level:
   • Full Access - Grants all permissions (recommended for integration use)
   • Restricted Access - Grants specific permissions based on requirements
6. Click Create & View
7. Copy the API key value (it will only be displayed once)

For more information about creating API keys, refer to the SendGrid API Keys documentation.

Configure the Connection

• Enter the API key into the API Key field in the connection configuration

API Key Security

The API key is only displayed once upon creation. Store it securely. If the key is lost, a new one must be generated.

Input	Comments	Default
API Key	API Key from your SendGrid account. Generate one in Settings > API Keys. Learn more

Triggers

Managed Webhook Events

Receive event webhook notifications from SendGrid. Automatically creates and manages a webhook subscription when the instance is deployed, and removes the subscription when the instance is deleted.

Input	Comments	Default
Connection	The SendGrid connection to use.
Friendly Name	A friendly name to help differentiate between multiple webhooks.
Events	The events to track.	["delivered"]

Manual Webhook

Receive and validate webhook requests from SendGrid for manually configured webhooks.

Actions

Add or Update Contact

Add or update a contact. This can also be used to add contacts to a list.

Input	Comments	Default
Connection	The SendGrid connection to use.
List IDs	Comma-separated IDs of the lists to add the contact to. These lists must already exist.
Contacts	An array of contact objects to add or update. See SendGrid docs for contact object structure.

Create List

Create a new contact list

Input	Comments	Default
Connection	The SendGrid connection to use.
List Name	The name of the list to create.

Create Webhook

Create a new Event Webhook configuration to receive email event data.

Input	Comments	Default
Connection	The SendGrid connection to use.
Webhook URL	The URL where SendGrid will send event data.
Friendly Name	A friendly name to help differentiate between multiple webhooks.
Enabled	When true, enables the Event Webhook.	true
Events	The events to track.	["delivered"]

Delete Webhook

Delete an Event Webhook configuration.

Input	Comments	Default
Connection	The SendGrid connection to use.
Webhook ID	The ID of the webhook.

Get All Field Definitions

Retrieve all custom field definitions with pagination support

Input	Comments	Default
Connection	The SendGrid connection to use.
Page Size	Number of results to return per page (max 100).
Page Token	Token for fetching the next or previous page of results.
Fetch All	When true, fetches all pages of results using pagination.	false

Get All Lists

Retrieve all contact lists with pagination support

Input	Comments	Default
Connection	The SendGrid connection to use.
Page Size	Number of results to return per page (max 100).
Page Token	Token for fetching the next or previous page of results.
Fetch All	When true, fetches all pages of results using pagination.	false

Get Contacts by Emails

Retrieve contacts by their email addresses.

Input	Comments	Default
Connection	The SendGrid connection to use.
Emails	Comma-separated email addresses to search for.

Get Import Status

Check the status of a contact import job

Input	Comments	Default
Connection	The SendGrid connection to use.
Job ID	The job ID returned from Import Contacts, Add/Update Contact, or Delete Contacts operations.

Get List by ID

Retrieve a specific contact list by its ID

Input	Comments	Default
Connection	The SendGrid connection to use.
List ID	The ID of the list to retrieve.
Include Sample Contacts	When true, includes a sample of contacts in the response.	false

Get Webhook

Retrieve an Event Webhook configuration by ID.

Input	Comments	Default
Connection	The SendGrid connection to use.
Webhook ID	The ID of the webhook.

Initiate Contacts Import

Initiates a CSV contact import. Returns a URL and headers for uploading the CSV file.

Input	Comments	Default
Connection	The SendGrid connection to use.
List IDs	Comma-separated IDs of the lists to add the contact to. These lists must already exist.
Field Mappings	An array of field definition IDs to map the uploaded CSV columns. Use null to skip a column. Get IDs from 'Get All Field Definitions' action.
Is Compressed	When true, indicates that the CSV file will be gzip-compressed.	false

List Webhooks

List all Event Webhook configurations.

Input	Comments	Default
Connection	The SendGrid connection to use.

Raw Request

Send raw HTTP request to SendGrid

Input	Comments	Default
Connection	The SendGrid connection to use.
URL	Input the path only (/templates), The base URL is already included (https://api.sendgrid.com/v3). For example, to connect to https://api.sendgrid.com/v3/templates, only /templates is entered in this field.
Method	The HTTP method to use.
Data	The HTTP body payload to send to the URL.
Form Data	The Form Data to be sent as a multipart form upload.
File Data	File Data to be sent as a multipart form upload.
File Data File Names	File names to apply to the file data inputs. Keys must match the file data keys above.
Query Parameter	A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
Header	A list of headers to send with the request.
Response Type	The type of data you expect in the response. You can request json, text, or binary data.	json
Timeout	The maximum time that a client will await a response to its request
Retry Delay (ms)	The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.	0
Retry On All Errors	If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.	false
Max Retry Count	The maximum number of retries to attempt. Specify 0 for no retries.	0
Use Exponential Backoff	Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.	false

Send Email

Send a single email to one or more recipients

Input	Comments	Default
Connection	The SendGrid connection to use.
To	The recipient's email address, or a comma-separated list of recipient email addresses.
From Email	The sender's email address.
Subject	The email subject line.
Text	The text body of the email.
CC	The recipient's email address, or a comma-separated list of recipient email addresses to CC.
BCC	The recipient's email address, or a comma-separated list of recipient email addresses to BCC.
From Name	The sender's name.
Reply To Email	Email To Reply To.
Reply To Name	Name to reply to. This field is only required when you provide a value for Reply To Email.
HTML	The optional HTML body of the email.
Personalizations	You can use this field to overwrite multiple properties of the email. For examples of which properties to use, checkout the SendGrid docs: https://docs.sendgrid.com/for-developers/sending-email/personalizations	[]
Attachment Content	Provide attachment data to send with the email. The 'File Name' field is required when using this input and should reference the data output from a previous action.
Disposition	Specifies how you would like the attachment to be displayed.
File Name	Provide a name for the file to attach. The 'Attachment Content' field is required when using this input.
File Type	The MIME type of the content you are attaching.
Content Id	Provide the content Id of the attachment. This value is only required when you select 'inline'.
Multiple Attachments	Provide an array of attachments to send with the email. See https://www.twilio.com/docs/sendgrid/api-reference/mail-send/mail-send#request-body for more information.
Subscription Tracking	When true, inserts a subscription management link at the bottom of the text and HTML bodies of your email.	false

Send Email with Dynamic Template

Send an email using a SendGrid dynamic template with complex nested JSON data

Input	Comments	Default
Connection	The SendGrid connection to use.
Template ID	The ID of the dynamic template to use.
Dynamic Template Data	The data to be used for the dynamic template. Supports complex nested JSON structures including arrays and objects for order confirmations, customer data, and more.
From Email	The sender's email address.
To	The recipient's email address, or a comma-separated list of recipient email addresses. Required if 'Personalizations' is not provided. Will be ignored if 'Personalizations' is provided.
From Name	The sender's name.
CC	The recipient's email address, or a comma-separated list of recipient email addresses to CC. Will be ignored if 'Personalizations' is provided.
BCC	The recipient's email address, or a comma-separated list of recipient email addresses to BCC. Will be ignored if 'Personalizations' is provided.
Reply To Email	Email To Reply To.
Reply To Name	Name to reply to. This field is only required when you provide a value for Reply To Email.
Personalizations	Advanced: Provide a personalizations array to send different variations to different recipients. When provided, this will override 'To', 'CC', and 'BCC' inputs. Each personalization will automatically include the dynamic template data.	[]

Send Multiple Emails

Send a separate email to each recipient

Input	Comments	Default
Connection	The SendGrid connection to use.
To	The recipient's email address, or a comma-separated list of recipient email addresses.
From Email	The sender's email address.
Subject	The email subject line.
Text	The text body of the email.
CC	The recipient's email address, or a comma-separated list of recipient email addresses to CC.
BCC	The recipient's email address, or a comma-separated list of recipient email addresses to BCC.
From Name	The sender's name.
Reply To Email	Email To Reply To.
Reply To Name	Name to reply to. This field is only required when you provide a value for Reply To Email.
HTML	The optional HTML body of the email.
Personalizations	You can use this field to overwrite multiple properties of the email. For examples of which properties to use, checkout the SendGrid docs: https://docs.sendgrid.com/for-developers/sending-email/personalizations	[]
Attachment Content	Provide attachment data to send with the email. The 'File Name' field is required when using this input and should reference the data output from a previous action.
Disposition	Specifies how you would like the attachment to be displayed.
File Name	Provide a name for the file to attach. The 'Attachment Content' field is required when using this input.
File Type	The MIME type of the content you are attaching.
Content Id	Provide the content Id of the attachment. This value is only required when you select 'inline'.
Multiple Attachments	Provide an array of attachments to send with the email. See https://www.twilio.com/docs/sendgrid/api-reference/mail-send/mail-send#request-body for more information.

Test Webhook

Test an Event Webhook by sending a fake event notification.

Input	Comments	Default
Connection	The SendGrid connection to use.
Test URL	The URL where the test event will be sent.

Toggle Signature Verification

Enable or disable signature verification for an Event Webhook.

Input	Comments	Default
Connection	The SendGrid connection to use.
Webhook ID	The ID of the webhook.
Enable Signature Verification	When true, enables signature verification for webhook requests.	true

Update Webhook

Update an existing Event Webhook configuration.

Input	Comments	Default
Connection	The SendGrid connection to use.
Webhook ID	The ID of the webhook.
Webhook URL	The URL where SendGrid will send event data.
Friendly Name	A friendly name to help differentiate between multiple webhooks.
Enabled	When true, enables the Event Webhook.	true
Events	The events to track.	["delivered"]