Skip to main content
Server path: /sendgrid | Type: Application | PCID required: Yes

Tools

ToolDescription
sendgrid_send_emailSend an email via SendGrid. Supports HTML/plain text, CC/BCC, attachments via URL, and SendGrid templates
sendgrid_create_templateCreate a new email template container in SendGrid. After creating, use sendgrid_create_template_version to add content
sendgrid_get_templateRetrieve an email template including all versions. Returns template metadata and version content
sendgrid_list_templatesList all email templates in SendGrid. Returns template IDs needed for sendgrid_send_email
sendgrid_create_template_versionCreate a new version of an email template
sendgrid_update_template_versionUpdate an existing template version
sendgrid_add_contactAdd a contact to SendGrid
sendgrid_get_contactRetrieve a contact by ID or email
sendgrid_update_contactUpdate an existing contact
sendgrid_delete_contactDelete a contact from SendGrid
sendgrid_create_listCreate a new contact list
sendgrid_get_listRetrieve a contact list by ID
sendgrid_list_contactsList all contacts with optional filtering
sendgrid_search_contactsSearch contacts using SendGrid query language
sendgrid_add_contacts_to_listAdd contacts to a specific list
sendgrid_remove_contacts_from_listRemove contacts from a specific list
sendgrid_get_email_statsGet email statistics for a date range
sendgrid_get_bounce_statsRetrieve bounced email records from SendGrid suppression list
sendgrid_get_suppression_groupsList all suppression groups (unsubscribe groups)
sendgrid_create_suppression_groupCreate a new suppression group
sendgrid_list_verified_sendersList all verified sender identities. Use to check which “from” addresses are available for sending
sendgrid_delete_templateDelete an email template and all its versions
sendgrid_delete_template_versionDelete a specific version of an email template
sendgrid_get_blocksRetrieve emails blocked by receiving servers. Blocks occur when the receiving server rejects the message
sendgrid_get_spam_reportsRetrieve emails that recipients reported as spam. Critical for monitoring sender reputation
sendgrid_get_invalid_emailsRetrieve invalid email addresses that could not receive mail due to formatting or DNS issues
sendgrid_get_global_suppressionsRetrieve globally unsubscribed email addresses. These addresses will not receive any emails
sendgrid_get_categoriesRetrieve all email categories used for organizing and filtering email statistics
sendgrid_get_authenticated_domainsList all authenticated (whitelabel) domains. Shows domain verification status for sender reputation
sendgrid_list_api_keysList all API keys for the account. Returns key names and IDs only (not the secret values)
sendgrid_get_inbound_parse_settingsRetrieve all inbound parse webhook settings. Shows which domains are configured to receive and parse incoming emails
sendgrid_list_single_sendsList all Single Send campaigns. Requires Marketing Campaigns plan
sendgrid_validate_emailValidate an email address using SendGrid validation. Requires Email Validation add-on

sendgrid_send_email

Send an email via SendGrid. Supports HTML/plain text, CC/BCC, attachments via URL, and SendGrid templates Parameters:
ParameterTypeRequiredDefaultDescription
toobject[]YesRecipients array. Example: [{“email”: “john@example.com”, “name”: “John Smith”}]
fromobjectYesSender info. Email must be verified domain/address in SendGrid
subjectstringYesEmail subject line. Example: “Your Order Confirmation”
contentobject[]YesEmail body content. Provide both text/plain and text/html for best compatibility. Example: [{“type”: “text/plain”, “value”: “Hello”}, {“type”: “text/html”, “value”: “<p>Hello</p>”}]
reply_toobjectNoReply-to address (where replies go if different from sender)
ccobject[]NoCC recipients (visible to all). Example: [{“email”: “cc@example.com”}]
bccobject[]NoBCC recipients (hidden from others). Example: [{“email”: “archive@example.com”}]
attachmentsobject[]NoPre-encoded attachments (base64). Use attachmentUrls for URL-based attachments
attachmentUrlsstring[]NoURLs of files to attach. Files will be fetched and attached automatically. Example: [“https://example.com/report.pdf”]
template_idstringNoSendGrid dynamic template ID. Get from sendgrid_list_templates. When used, subject and content may be optional
dynamic_template_dataobjectNoTemplate variable substitutions. Example: {“firstName”: “John”, “orderNumber”: “12345”}

sendgrid_create_template

Create a new email template container in SendGrid. After creating, use sendgrid_create_template_version to add content Parameters:
ParameterTypeRequiredDefaultDescription
namestringYesTemplate name for identification. Example: “Order Confirmation”, “Welcome Email”
generationstringNo"dynamic"”dynamic” for templates with {{handlebar}} variables (recommended). “legacy” for older format

sendgrid_get_template

Retrieve an email template including all versions. Returns template metadata and version content Parameters:
ParameterTypeRequiredDefaultDescription
template_idstringYesTemplate ID to retrieve. Get from sendgrid_list_templates or sendgrid_create_template response

sendgrid_list_templates

List all email templates in SendGrid. Returns template IDs needed for sendgrid_send_email Parameters:
ParameterTypeRequiredDefaultDescription
generationsstringNoFilter by type. “dynamic” = modern templates with variables. Default: returns all
page_sizenumberNo50Number of templates per page. Default: 50. Max: 200

sendgrid_create_template_version

Create a new version of an email template Parameters:
ParameterTypeRequiredDefaultDescription
template_idstringYesTemplate ID
namestringYesVersion name
subjectstringYesEmail subject template
html_contentstringNoHTML content template
plain_contentstringNoPlain text content template
activebooleanNoWhether this version is active
test_dataobjectNoTest data for template variables

sendgrid_update_template_version

Update an existing template version Parameters:
ParameterTypeRequiredDefaultDescription
template_idstringYesTemplate ID
version_idstringYesVersion ID to update
namestringNoVersion name
subjectstringNoEmail subject template
html_contentstringNoHTML content template
plain_contentstringNoPlain text content template
activebooleanNoWhether this version is active

sendgrid_add_contact

Add a contact to SendGrid Parameters:
ParameterTypeRequiredDefaultDescription
emailstringYesContact email address
first_namestringNoContact first name
last_namestringNoContact last name
custom_fieldsobjectNoCustom field values for the contact
list_idsstring[]NoList IDs to add the contact to

sendgrid_get_contact

Retrieve a contact by ID or email Parameters:
ParameterTypeRequiredDefaultDescription
contact_idstringNoContact ID
emailstringNoContact email address

sendgrid_update_contact

Update an existing contact Parameters:
ParameterTypeRequiredDefaultDescription
contact_idstringYesContact ID to update
emailstringNoNew email address
first_namestringNoNew first name
last_namestringNoNew last name
custom_fieldsobjectNoUpdated custom field values

sendgrid_delete_contact

Delete a contact from SendGrid Parameters:
ParameterTypeRequiredDefaultDescription
contact_idstringYesContact ID to delete

sendgrid_create_list

Create a new contact list Parameters:
ParameterTypeRequiredDefaultDescription
namestringYesList name

sendgrid_get_list

Retrieve a contact list by ID Parameters:
ParameterTypeRequiredDefaultDescription
list_idstringYesList ID to retrieve

sendgrid_list_contacts

List all contacts with optional filtering Parameters:
ParameterTypeRequiredDefaultDescription
page_sizenumberNo100Number of contacts per page (1-1000)
page_tokenstringNoPage token for pagination

sendgrid_search_contacts

Search contacts using SendGrid query language Parameters:
ParameterTypeRequiredDefaultDescription
querystringYesSearch query using SendGrid query language (e.g., “email LIKE ’%@example.com’“)

sendgrid_add_contacts_to_list

Add contacts to a specific list Parameters:
ParameterTypeRequiredDefaultDescription
list_idstringYesList ID
contact_idsstring[]YesArray of contact IDs to add to the list

sendgrid_remove_contacts_from_list

Remove contacts from a specific list Parameters:
ParameterTypeRequiredDefaultDescription
list_idstringYesList ID
contact_idsstring[]YesArray of contact IDs to remove from the list

sendgrid_get_email_stats

Get email statistics for a date range Parameters:
ParameterTypeRequiredDefaultDescription
start_datestringYesStart date for stats (YYYY-MM-DD format)
end_datestringYesEnd date for stats (YYYY-MM-DD format)
aggregated_bystringNo"day"How to aggregate the statistics
tagsstring[]NoFilter by specific tags
categoriesstring[]NoFilter by specific categories

sendgrid_get_bounce_stats

Retrieve bounced email records from SendGrid suppression list Parameters:
ParameterTypeRequiredDefaultDescription
start_datestringNoStart date filter (YYYY-MM-DD format)
end_datestringNoEnd date filter (YYYY-MM-DD format)
limitnumberNoMaximum number of records to return (1-500)

sendgrid_get_suppression_groups

List all suppression groups (unsubscribe groups)

sendgrid_create_suppression_group

Create a new suppression group Parameters:
ParameterTypeRequiredDefaultDescription
namestringYesSuppression group name
descriptionstringYesSuppression group description
is_defaultbooleanNofalseWhether this is the default suppression group

sendgrid_list_verified_senders

List all verified sender identities. Use to check which “from” addresses are available for sending

sendgrid_delete_template

Delete an email template and all its versions Parameters:
ParameterTypeRequiredDefaultDescription
template_idstringYesTemplate ID to delete

sendgrid_delete_template_version

Delete a specific version of an email template Parameters:
ParameterTypeRequiredDefaultDescription
template_idstringYesTemplate ID
version_idstringYesVersion ID to delete

sendgrid_get_blocks

Retrieve emails blocked by receiving servers. Blocks occur when the receiving server rejects the message Parameters:
ParameterTypeRequiredDefaultDescription
start_datestringNoStart date filter (YYYY-MM-DD format)
end_datestringNoEnd date filter (YYYY-MM-DD format)
limitnumberNoMaximum number of records to return (1-500)

sendgrid_get_spam_reports

Retrieve emails that recipients reported as spam. Critical for monitoring sender reputation Parameters:
ParameterTypeRequiredDefaultDescription
start_datestringNoStart date filter (YYYY-MM-DD format)
end_datestringNoEnd date filter (YYYY-MM-DD format)
limitnumberNoMaximum number of records to return (1-500)

sendgrid_get_invalid_emails

Retrieve invalid email addresses that could not receive mail due to formatting or DNS issues Parameters:
ParameterTypeRequiredDefaultDescription
start_datestringNoStart date filter (YYYY-MM-DD format)
end_datestringNoEnd date filter (YYYY-MM-DD format)
limitnumberNoMaximum number of records to return (1-500)

sendgrid_get_global_suppressions

Retrieve globally unsubscribed email addresses. These addresses will not receive any emails Parameters:
ParameterTypeRequiredDefaultDescription
start_datestringNoStart date filter (YYYY-MM-DD format)
end_datestringNoEnd date filter (YYYY-MM-DD format)
limitnumberNoMaximum number of records to return
offsetnumberNoNumber of records to skip for pagination

sendgrid_get_categories

Retrieve all email categories used for organizing and filtering email statistics Parameters:
ParameterTypeRequiredDefaultDescription
limitnumberNoNumber of categories to return (default: 50)
offsetnumberNoNumber of categories to skip for pagination
categorystringNoPrefix search filter on category names

sendgrid_get_authenticated_domains

List all authenticated (whitelabel) domains. Shows domain verification status for sender reputation Parameters:
ParameterTypeRequiredDefaultDescription
limitnumberNoNumber of domains to return
offsetnumberNoNumber of domains to skip for pagination

sendgrid_list_api_keys

List all API keys for the account. Returns key names and IDs only (not the secret values) Parameters:
ParameterTypeRequiredDefaultDescription
limitnumberNoMaximum number of keys to return

sendgrid_get_inbound_parse_settings

Retrieve all inbound parse webhook settings. Shows which domains are configured to receive and parse incoming emails

sendgrid_list_single_sends

List all Single Send campaigns. Requires Marketing Campaigns plan Parameters:
ParameterTypeRequiredDefaultDescription
page_sizenumberNoNumber of results per page
page_tokenstringNoPagination token for next page

sendgrid_validate_email

Validate an email address using SendGrid validation. Requires Email Validation add-on Parameters:
ParameterTypeRequiredDefaultDescription
emailstringYesEmail address to validate
sourcestringNoSource identifier for tracking validation requests