rocketkind
Communication

SendGrid

SendGrid (Twilio SendGrid) sends email — transactional mail through the v3 Mail Send API, and Marketing Campaigns on top of it: contacts, lists, dynamic templates, single sends and suppressions.

Authentication

  • API key

Actions

Generic API request. Call any SendGrid API endpoint on this connection, for the case where no shipped action covers it yet. The connection supplies the base URL, the authentication and the egress route, so only the path, query and body are yours to fill.

  • Add global suppressionAdd one or more email addresses to the global unsubscribe (suppression) list (POST /asm/suppressions/global, application/json).
  • Add or update contactsAdd or update (upsert) Marketing Campaigns contacts (PUT /marketing/contacts, application/json).
  • Create marketing listCreate a Marketing Campaigns contact list (POST /marketing/lists, application/json).
  • Create single sendCreate a Marketing Campaigns Single Send email (POST /marketing/singlesends, application/json).
  • Create templateCreate an empty transactional email template - the container a version's subject and HTML are later added to, so this alone does not produce a sendable template.
  • Delete contactsDestructiveDelete Marketing Campaigns contacts by id, or delete every contact (DELETE /marketing/contacts).
  • Delete marketing listDestructiveDelete a Marketing Campaigns contact list (DELETE /marketing/lists/{id}).
  • Get contactRetrieve a single Marketing Campaigns contact by id (GET /marketing/contacts/{id}).
  • Get marketing listRetrieve a single Marketing Campaigns list by id (GET /marketing/lists/{id}).
  • Get user profileRetrieve the authenticated SendGrid account profile (GET /user/profile).
  • List contactsSample the Marketing Campaigns contacts on the account so you can pick a contact id without writing an SGQL query.
  • List dynamic templatesList the transactional templates on the account so you can resolve a template name to the d-...
  • List marketing listsList the Marketing Campaigns contact lists with each one's id, name and contactcount - use it to resolve a list name to the id that Get marketing list, Update marketing list and contact operations take.
  • List suppression groupsList the unsubscribe groups (SendGrid calls them ASM groups) - the opt-out categories a recipient can unsubscribe from individually rather than blocking all mail.
  • Search contactsSearch Marketing Campaigns contacts with a SGQL query (POST /marketing/contacts/search, application/json).
  • Send mailSend an email via the SendGrid v3 Mail Send API (POST /mail/send, application/json).
  • Update marketing listDestructiveRename a Marketing Campaigns contact list (PATCH /marketing/lists/{id}, application/json).

Triggers

  • Email bounced (webhook)Starts the instant an email sent through the connected SendGrid account bounces, delivered by a webhook instead of polling.
  • Email delivered (webhook)Starts the instant an email sent through the connected SendGrid account is accepted by the recipient's mail server, delivered by a webhook instead of polling.
  • Email link clicked (webhook)Starts the instant a recipient clicks a tracked link in an email sent through the connected SendGrid account, delivered by a webhook instead of polling.
  • Email opened (webhook)Starts the instant a recipient opens an email sent through the connected SendGrid account, delivered by a webhook instead of polling.
  • Email receivedStarts when an email arrives at a receiving hostname whose MX record points at SendGrid, delivered by SendGrid's Inbound Parse webhook as parsed fields.
  • Emails to a receiving hostnameAnswers as an agent by email: when someone writes to an address at a hostname SendGrid's Inbound Parse receives for, the agent replies in the same email thread.
  • New or updated contactStarts when a marketing contact is added or updated in the connected SendGrid account.

Product names, logos and brands are the property of their respective owners and are used here for identification only. Their use does not imply endorsement by, or affiliation with, those owners.