Twilio SendGrid

Twilio SendGrid — send transactional and marketing emails, manage contacts and templates.

Overview

Property	Value
Type	http
Authentication	bearer
Category	Communication

Configuration

Field	Type	Required	Description
api_key	string	Yes	SendGrid API key (starts with SG.)

Available actions

Send Email

Send a transactional or marketing email via SendGrid.

Endpoint	POST /mail/send
Method	POST

List Contacts

Retrieve all contacts from the SendGrid Marketing Contacts database.

Endpoint	GET /marketing/contacts
Method	GET

Add or Update Contacts

Add or update contacts in the SendGrid Marketing Contacts database. Upserts by email address.

Endpoint	PUT /marketing/contacts
Method	PUT

Get Contact

Retrieve a single contact by ID.

Endpoint	GET /marketing/contacts/{contactId}
Method	GET

Delete Contacts

Delete one or more contacts by ID. This is a bulk operation.

Endpoint	DELETE /marketing/contacts
Method	DELETE

List Templates

List email templates (transactional and marketing).

Endpoint	GET /templates
Method	GET

Example flow

name: new-user-welcome-email
description: Add new signups to SendGrid and send a welcome email
trigger:
  connector: webhook
  event: user.signup

steps:
  - name: add-contact
    action: sendgrid.add-contacts
    params:
      contacts:
        - email: "{{ trigger.payload.email }}"
          first_name: "{{ trigger.payload.first_name }}"
          last_name: "{{ trigger.payload.last_name }}"

  - name: list-welcome-templates
    action: sendgrid.list-templates
    params:
      generations: dynamic

  - name: send-welcome-email
    action: sendgrid.send-email
    params:
      personalizations:
        - to:
            - email: "{{ trigger.payload.email }}"
              name: "{{ trigger.payload.first_name }} {{ trigger.payload.last_name }}"
          dynamic_template_data:
            first_name: "{{ trigger.payload.first_name }}"
      from:
        email: welcome@acmecorp.com
        name: Acme Corp
      template_id: "{{ steps.list-welcome-templates.output.result[0].id }}"