SendGrid

App · Email · 6 actions

Send emails and manage your marketing contacts in SendGrid.

Actions

ActionWhat it does
Add contact to listAdd contacts to a SendGrid marketing list.
Create marketing listCreate a marketing list for SendGrid contacts.
Get email statsRetrieve SendGrid email statistics for a date range.
List templatesList SendGrid email templates.
Send emailSend an email through SendGrid.
Send template emailSend an email built from a saved SendGrid template.

Add contact to list

Add contacts to a SendGrid marketing list.

Inputs

EmailemailtextRequired
Contact email address to add.
List IDSlist_idslistRequired
Marketing list IDs to add the contact to.

Outputs

resultobject
Example output
{
  "result": {
    "job_id": "job_987"
  }
}

Create marketing list

Create a marketing list for SendGrid contacts.

Inputs

NamenametextRequired
List name.

Outputs

resultobject
Example output
{
  "result": {
    "contact_count": 0,
    "id": "list_789",
    "name": "My List"
  }
}

Get email stats

Retrieve SendGrid email statistics for a date range.

Inputs

Start datestart_datetextRequired
Start date (YYYY-MM-DD).
End dateend_datetextRequired
End date (YYYY-MM-DD).

Outputs

resultobject
Example output
{
  "result": {
    "stats": [
      {
        "date": "2024-01-01",
        "stats": [
          {
            "metrics": {
              "clicks": 10,
              "delivered": 95,
              "opens": 50,
              "requests": 100
            }
          }
        ]
      }
    ]
  }
}

List templates

List SendGrid email templates.

Inputs

None.

Outputs

resultobject
Example output
{
  "result": {
    "result": [
      {
        "id": "tmpl_123",
        "name": "Welcome Email"
      }
    ]
  }
}

Send email

Send an email through SendGrid.

Inputs

From emailfrom_emailtextRequired
Sender email address.
To emailto_emailtextRequired
Recipient email address.
SubjectsubjecttextRequired
Email subject.
Text contenttext_contenttextRequired
Plain text email content.
HTML contenthtml_contenttext
Optional HTML email content.
CCcclist
Optional CC email addresses.
BCCbcclist
Optional BCC email addresses.

Outputs

resultobject
Example output
{
  "result": {
    "status_code": 202
  }
}

Send template email

Send an email built from a saved SendGrid template.

Inputs

From emailfrom_emailtextRequired
Sender email address.
To emailto_emailtextRequired
Recipient email address.
Template IDtemplate_idtextRequired
The ID of the SendGrid template to use.
Template valuesdynamic_dataobject
Values to fill into the template's placeholders.

Outputs

resultobject
Example output
{
  "result": {
    "status_code": 202
  }
}

On this page