Send transactional email and manage templates, contacts, lists and recipient status.
Explore 27 workflow actions for SendGrid, including account permissions and operation limits.
16 read actions11 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Activate dynamic template version
Write
Make one SendGrid dynamic template version active for future sends.
Permissions and limits
Account permissions
templates.versions.activate.create
Operation limits
Activating this version replaces the previously active version for future sends. EU regional accounts are not supported.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create contact list
Write
Create a named static Marketing Campaigns contact list.
Permissions and limits
Account permissions
Marketing lists edit access
Operation limits
SendGrid allows at most 1,000 lists per account. A lost creation receipt remains uncertain. EU regional accounts are not supported.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create dynamic template
Write
Create a named SendGrid dynamic transactional template.
Permissions and limits
Account permissions
templates.create
Operation limits
The template needs a version before it can send mail. SendGrid limits templates per account. EU regional accounts are not supported.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create dynamic template version
Write
Create a code-edited content version for an existing dynamic template.
Permissions and limits
Account permissions
templates.versions.create
Operation limits
SendGrid automatically activates the first version. Use Activate dynamic template version to switch an existing template. HTML and plain text are limited to 100,000 characters each in NodeHub. EU regional accounts are not supported.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create or update contact
Write
Queue one Marketing Campaigns contact for creation or update.
Permissions and limits
Account permissions
Marketing contacts edit access
Operation limits
SendGrid processes the write asynchronously. Use Get contact import job to confirm completion. NodeHub sends one bounded contact per run. EU regional accounts are not supported.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete contact list
Write
Delete one Marketing Campaigns list, optionally deleting all contacts that belong to it.
Permissions and limits
Account permissions
Marketing lists edit access
Operation limits
Deleting the list cannot be undone. If deleteContacts is true, SendGrid queues permanent contact deletion and returns a job ID. A lost receipt remains uncertain. EU regional accounts are not supported.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete contacts
Write
Queue permanent deletion for one to 100 exact Marketing Campaigns contact IDs.
Permissions and limits
Account permissions
Marketing contacts edit access
Operation limits
This permanently deletes contacts from the account and is asynchronous. Use Get contact import job to confirm completion. A lost acceptance receipt remains uncertain. EU regional accounts are not supported.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Get block
Read
Read SendGrid block records for one recipient email address.
Permissions and limits
Account permissions
suppression.blocks.read
Operation limits
SendGrid does not suppress future mail to blocked addresses by default. An empty list is not a delivery guarantee. EU regional accounts are not supported.
Get bounce
Read
Read SendGrid bounce records for one recipient email address.
Permissions and limits
Account permissions
suppression.bounces.read
Operation limits
Returns an empty list when SendGrid has no bounce record for this address. Temporary and permanent bounce details can differ. EU regional accounts are not supported.
Get contact
Read
Read one Marketing Campaigns contact by exact SendGrid ID.
Permissions and limits
Account permissions
Marketing contacts read access
Operation limits
Use SendGrid's identifier-search endpoints first when only an email, phone number, external ID or anonymous ID is known. EU regional accounts are not supported.
Get contact export
Read
Read status and signed download URLs for one contact export job.
Permissions and limits
Account permissions
Marketing contacts export access
Operation limits
Ready URLs are short-lived provider-signed downloads and may contain multiple files. This operation returns the URLs but does not download contact data. EU regional accounts are not supported.
Get contact import job
Read
Read completion status for a contact upsert or deletion job.
Permissions and limits
Account permissions
Marketing contacts read access
Operation limits
An errored job can contain partial failures. SendGrid may provide an external errors URL that NodeHub omits from workflow output. EU regional accounts are not supported.
Get contact list
Read
Read one Marketing Campaigns list and optionally include up to 50 recent contacts.
Permissions and limits
Account permissions
Marketing lists read access
Operation limits
contactSample returns at most 50 recently attached contacts. EU regional accounts are not supported.
Get dynamic template
Read
Read metadata for one SendGrid dynamic template.
Permissions and limits
Account permissions
templates.read
Operation limits
Template version contents are omitted from workflow output. EU regional accounts are not supported.
Get email suppression groups
Read
Read the unsubscribe groups associated with one email address.
Permissions and limits
Account permissions
Depends on the connected account and selected operation. Check the service documentation.
Operation limits
Check each returned group's suppressed field. Global suppressions are a separate API. EU regional accounts are not supported.
Get global suppression
Read
Check whether an email address is globally unsubscribed in SendGrid.
Permissions and limits
Account permissions
Depends on the connected account and selected operation. Check the service documentation.
Operation limits
SendGrid returns an empty object when the address is not globally suppressed. An empty result does not prove delivery eligibility because bounces, blocks and group suppressions are separate. EU regional accounts are not supported.
Get invalid email
Read
Read SendGrid's invalid-address record for one email address.
Permissions and limits
Account permissions
suppression.invalid_emails.read
Operation limits
An empty list means SendGrid has no invalid-address record, not that the address has been verified. EU regional accounts are not supported.
Get spam report
Read
Read whether this recipient reported SendGrid mail as spam.
Permissions and limits
Account permissions
suppression.spam_reports.read
Operation limits
Spam reports depend on ISP feedback and do not cover every recipient. EU regional accounts are not supported.
List contact lists
Read
Read one cursor page of Marketing Campaigns contact lists.
Permissions and limits
Account permissions
Marketing lists read access
Operation limits
Returns one page. Extract page_token from _metadata.next and pass it as pageToken to continue. EU regional accounts are not supported.
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
List dynamic templates
Read
Read one page of SendGrid dynamic transactional templates.
Permissions and limits
Account permissions
templates.read
Operation limits
Returns one page. Extract page_token from _metadata.next and pass it as pageToken to continue. EU regional accounts are not supported.
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
List global suppressions
Read
Read one page of globally unsubscribed email addresses.
Permissions and limits
Account permissions
Depends on the connected account and selected operation. Check the service documentation.
Operation limits
Returns one page. Increase offset by limit to continue. EU regional accounts are not supported.
Pagination: offset. Check the result for additional pages; a single action may not return every record.
List recent contacts
Read
Read SendGrid's bounded sample of up to 50 recent Marketing Campaigns contacts.
Permissions and limits
Account permissions
Marketing contacts read access
Operation limits
SendGrid deprecated pagination and returns at most 50 recent contacts. Use Start contact export and Get contact export for a complete account export. EU regional accounts are not supported.
List suppression groups
Read
Read the account's unsubscribe groups.
Permissions and limits
Account permissions
Depends on the connected account and selected operation. Check the service documentation.
Operation limits
Account permissions determine which groups are visible. EU regional accounts are not supported.
Send dynamic template email
Write
Send one email using an active SendGrid dynamic transactional template.
Permissions and limits
Account permissions
mail.send
Operation limits
The sender must be verified and the template must have an active version. Only scalar template data is supported. A missing or lost message receipt is uncertain and is not resent automatically. EU regional accounts are not supported.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send email
Write
Send one email to one recipient from a verified sender, as text, HTML or both.
Permissions and limits
Account permissions
Depends on the connected account and selected operation. Check the service documentation.
Operation limits
Give text, HTML or both. EU-hosted accounts (api.eu.sendgrid.com) are not supported yet.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Start contact export
Write
Start a complete JSON export of Marketing Campaigns contacts.
Permissions and limits
Account permissions
Marketing contacts export access
Operation limits
The export is asynchronous. Poll Get contact export with the returned ID, then download each short-lived signed URL. A lost acceptance receipt remains uncertain. EU regional accounts are not supported.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update contact list
Write
Rename one Marketing Campaigns contact list.
Permissions and limits
Account permissions
Marketing lists edit access
Operation limits
Only the list name changes. A lost update receipt remains uncertain. EU regional accounts are not supported.
A repeated request may repeat the external action. Review the previous result before retrying a write.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in SendGrid. A saved workflow is not a completed provider action.
Messaging ยท CONNECTION
