Sim

SendGrid

Send emails and manage contacts, lists, and templates with SendGrid

SendGrid is a leading cloud-based email delivery platform trusted by developers and businesses to send reliable transactional and marketing emails at scale. With its robust APIs and powerful tools, SendGrid enables you to manage all aspects of your email communication, from sending notifications and receipts to managing complex marketing campaigns.

SendGrid empowers users with a full suite of email operations, allowing you to automate critical email workflows and closely manage contact lists, templates, and recipient engagement. Its seamless integration with Sim enables agents and workflows to deliver targeted messages, maintain dynamic contact and recipient lists, trigger personalized emails through templates, and track the results in real time.

Key features of SendGrid include:

  • Transactional Email: Send automated and high-volume transactional emails (like notifications, receipts, and password resets).
  • Dynamic Templates: Use rich HTML or text templates with dynamic data for highly personalized communication at scale.
  • Contact Management: Add and update marketing contacts, manage recipient lists, and target segments for campaigns.
  • Attachments Support: Include one or more file attachments in your emails.
  • Comprehensive API Coverage: Programmatically manage emails, contacts, lists, templates, suppression groups, and more.

By connecting SendGrid with Sim, your agents can:

  • Send both simple and advanced (templated or multi-recipient) emails as part of any workflow.
  • Manage and segment contacts and lists automatically.
  • Leverage templates for consistency and dynamic personalization.
  • Track and respond to email engagement within your automated processes.

This integration allows you to automate all critical communication flows, ensure messages reach the right audience, and maintain control over your organization’s email strategy, directly from Sim workflows.

Usage Instructions

Integrate SendGrid into your workflow. Send transactional emails, manage marketing contacts and lists, and work with email templates. Supports dynamic templates, attachments, and comprehensive contact management.

Tools

sendgrid_send_mail

Send an email using SendGrid API

Input

ParameterTypeRequiredDescription
apiKeystringYesSendGrid API key
fromstringYesSender email address (must be verified in SendGrid)
fromNamestringNoSender name
tostringYesRecipient email address
toNamestringNoRecipient name
subjectstringNoEmail subject (required unless using a template with pre-defined subject)
contentstringNoEmail body content (required unless using a template with pre-defined content)
contentTypestringNoContent type (text/plain or text/html)
ccstringNoCC email address
bccstringNoBCC email address
replyTostringNoReply-to email address
replyToNamestringNoReply-to name
attachmentsfile[]NoFiles to attach to the email
templateIdstringNoSendGrid template ID to use
dynamicTemplateDatajsonNoJSON object of dynamic template data

Output

ParameterTypeDescription
successbooleanWhether the email was sent successfully
messageIdstringSendGrid message ID
tostringRecipient email address
subjectstringEmail subject

sendgrid_add_contact

Add a new contact to SendGrid

Input

ParameterTypeRequiredDescription
apiKeystringYesSendGrid API key
emailstringYesContact email address
firstNamestringNoContact first name
lastNamestringNoContact last name
customFieldsjsonNoJSON object of custom field key-value pairs (use field IDs like e1_T, e2_N, e3_D, not field names)
listIdsstringNoComma-separated list IDs to add the contact to

Output

ParameterTypeDescription
jobIdstringJob ID for tracking the async contact creation
emailstringContact email address
firstNamestringContact first name
lastNamestringContact last name
messagestringStatus message

sendgrid_get_contact

Get a specific contact by ID from SendGrid

Input

ParameterTypeRequiredDescription
apiKeystringYesSendGrid API key
contactIdstringYesContact ID

Output

ParameterTypeDescription
idstringContact ID
emailstringContact email address
firstNamestringContact first name
lastNamestringContact last name
createdAtstringCreation timestamp
updatedAtstringLast update timestamp
listIdsjsonArray of list IDs the contact belongs to
customFieldsjsonCustom field values

sendgrid_search_contacts

Search for contacts in SendGrid using a query

Input

ParameterTypeRequiredDescription
apiKeystringYesSendGrid API key
querystringYesSearch query (e.g., "email LIKE '%example.com%' AND CONTAINS(list_ids, 'list-id')")

Output

ParameterTypeDescription
contactsjsonArray of matching contacts
contactCountnumberTotal number of contacts found

sendgrid_delete_contacts

Delete one or more contacts from SendGrid

Input

ParameterTypeRequiredDescription
apiKeystringYesSendGrid API key
contactIdsstringYesComma-separated contact IDs to delete

Output

ParameterTypeDescription
jobIdstringJob ID for the deletion request

sendgrid_create_list

Create a new contact list in SendGrid

Input

ParameterTypeRequiredDescription
apiKeystringYesSendGrid API key
namestringYesList name

Output

ParameterTypeDescription
idstringList ID
namestringList name
contactCountnumberNumber of contacts in the list

sendgrid_get_list

Get a specific list by ID from SendGrid

Input

ParameterTypeRequiredDescription
apiKeystringYesSendGrid API key
listIdstringYesList ID

Output

ParameterTypeDescription
idstringList ID
namestringList name
contactCountnumberNumber of contacts in the list

sendgrid_list_all_lists

Get all contact lists from SendGrid

Input

ParameterTypeRequiredDescription
apiKeystringYesSendGrid API key
pageSizenumberNoNumber of lists to return per page (default: 100)

Output

ParameterTypeDescription
listsjsonArray of lists

sendgrid_delete_list

Delete a contact list from SendGrid

Input

ParameterTypeRequiredDescription
apiKeystringYesSendGrid API key
listIdstringYesList ID to delete

Output

ParameterTypeDescription
messagestringSuccess message

sendgrid_add_contacts_to_list

Add or update contacts and assign them to a list in SendGrid (uses PUT /v3/marketing/contacts)

Input

ParameterTypeRequiredDescription
apiKeystringYesSendGrid API key
listIdstringYesList ID to add contacts to
contactsjsonYesJSON array of contact objects. Each contact must have at least: email (or phone_number_id/external_id/anonymous_id). Example: [{"email": "user@example.com", "first_name": "John"}]

Output

ParameterTypeDescription
jobIdstringJob ID for tracking the async operation
messagestringStatus message

sendgrid_remove_contacts_from_list

Remove contacts from a specific list in SendGrid

Input

ParameterTypeRequiredDescription
apiKeystringYesSendGrid API key
listIdstringYesList ID
contactIdsstringYesComma-separated contact IDs to remove from the list

Output

ParameterTypeDescription
jobIdstringJob ID for the request

sendgrid_create_template

Create a new email template in SendGrid

Input

ParameterTypeRequiredDescription
apiKeystringYesSendGrid API key
namestringYesTemplate name
generationstringNoTemplate generation type (legacy or dynamic, default: dynamic)

Output

ParameterTypeDescription
idstringTemplate ID
namestringTemplate name
generationstringTemplate generation
updatedAtstringLast update timestamp
versionsjsonArray of template versions

sendgrid_get_template

Get a specific template by ID from SendGrid

Input

ParameterTypeRequiredDescription
apiKeystringYesSendGrid API key
templateIdstringYesTemplate ID

Output

ParameterTypeDescription
idstringTemplate ID
namestringTemplate name
generationstringTemplate generation
updatedAtstringLast update timestamp
versionsjsonArray of template versions

sendgrid_list_templates

Get all email templates from SendGrid

Input

ParameterTypeRequiredDescription
apiKeystringYesSendGrid API key
generationsstringNoFilter by generation (legacy, dynamic, or both)
pageSizenumberNoNumber of templates to return per page (default: 20)

Output

ParameterTypeDescription
templatesjsonArray of templates

sendgrid_delete_template

Delete an email template from SendGrid

Input

ParameterTypeRequiredDescription
apiKeystringYesSendGrid API key
templateIdstringYesTemplate ID to delete

Output

ParameterTypeDescription
successbooleanOperation success status
messageIdstringEmail message ID (send_mail)
idstringResource ID
jobIdstringJob ID for async operations
emailstringEmail address
firstNamestringFirst name
lastNamestringLast name
contactsjsonArray of contacts
contactCountnumberNumber of contacts
listsjsonArray of lists
templatesjsonArray of templates
messagestringStatus or success message
namestringResource name
generationstringTemplate generation

sendgrid_create_template_version

Create a new version of an email template in SendGrid

Input

ParameterTypeRequiredDescription
apiKeystringYesSendGrid API key
templateIdstringYesTemplate ID
namestringYesVersion name
subjectstringYesEmail subject line
htmlContentstringNoHTML content of the template
plainContentstringNoPlain text content of the template
activebooleanNoWhether this version is active (default: true)

Output

ParameterTypeDescription
idstringVersion ID
templateIdstringTemplate ID
namestringVersion name
subjectstringEmail subject
activebooleanWhether this version is active
htmlContentstringHTML content
plainContentstringPlain text content
updatedAtstringLast update timestamp

Notes

  • Category: tools
  • Type: sendgrid