SendGrid

sendEmail

Send a single email with full customization options. ⚠️ CRITICAL: 'to' and 'from' must be objects/arrays, NOT strings! 🚨 COMMON MISTAKE: Don't use strings for email addresses! 💡 WORKFLOW: 1️⃣ Verify sender with verifySender first, 2️⃣ Then sendEmail using verified sender address.

SendGrid

Available Tools(58)

sendBulkEmailsSend multiple personalized emails in bulk with different content per recipient

getTemplateRetrieve template details

deleteTemplateDelete a template

getTemplateVersionGet specific template version

addContactAdd single contact to SendGrid. ⚠️ CRITICAL: custom_fields must use field IDs (not names)! 💡 WORKFLOW: 1️⃣ Call listCustomFields to see field IDs, 2️⃣ OR createCustomField for new fields, 3️⃣ Then addContact with field IDs

updateContactListUpdate contact list

deleteTemplateVersionDelete template version

getContactRetrieve contact details

addContactsAdd multiple contacts to SendGrid in bulk. ⚠️ CRITICAL: custom_fields must use field IDs (not names) from your SendGrid account!

getContactListGet contact list details

removeContactsFromListRemove contacts from list

addContactsToListAdd contacts to specific list

validateEmailBulkValidate multiple email addresses

getEngagementStatsGet open/click statistics

getGlobalSuppressionsGet global suppressions

getEmailStatsGet email delivery statistics

getBlockStatsGet block statistics

getDomainAuthenticationGet domain auth status

getEmailActivityGet specific email activity

getCampaignGet campaign details

scheduleCampaignSchedule campaign for later

authenticateDomainSet up domain authentication

getSenderVerificationGet verification status of a sender identity

deleteCampaignDelete campaign

getWebhooksList all webhooks

deleteWebhookDelete webhook

getContactsByEmails🔍 RECOMMENDED: Find contacts by exact email addresses. Returns contact IDs needed for deleteContact! Much simpler and faster than searchContacts for exact email lookups. Use this when you know the exact email addresses.

createCustomField➕ Create a new custom field in SendGrid. Returns field ID for immediate use in contact operations. 💡 BEST PRACTICE: Create all needed fields first, then use listCustomFields to see all IDs, then proceed with contact operations.

createTemplateCreate a new email template

updateTemplateUpdate existing template

listTemplatesGet all templates (defaults to dynamic templates only). Use legacy: true to show old legacy templates instead.

updateTemplateVersionUpdate template version

updateContact✏️ Update existing contact information. ⚠️ CRITICAL: custom_fields must use field IDs (not names)! 💡 TIP: Use getContactsByEmails first to get contact_id, then call listCustomFields for field IDs.

createTemplateVersionCreate new template version

deleteContactDelete a contact from SendGrid. 💡 TIP: Use getContactsByEmails first to find the contact_id from email address!

searchContacts🔍 Advanced search using SGQL (SendGrid Query Language) for complex filtering. Use when you need pattern matching, list filtering, or date ranges. For simple email lookups, use getContactsByEmails instead.

createContactList📋 Create a new contact list for organizing contacts. Returns list_id that can be used in addContact to automatically add contacts to this list. Lists are just containers - they don't define custom fields.

deleteContactListDelete contact list

validateEmailValidate single email address

removeFromSuppressionListRemove from suppression list

addToSuppressionListAdd email to suppression list

getSpamReportStatsGet spam report statistics

getSuppressionListsGet all suppression lists

getBounceStatsGet bounce statistics

getDeliveryStatsGet delivery statistics

searchEmailActivitySearch email activity with filters

createWebhookCreate event webhook

updateCampaignUpdate campaign

getCampaignStatsGet campaign performance stats

verifySender🔐 ESSENTIAL SETUP: Create a verified sender identity for email authentication. This is REQUIRED before sending any emails! SendGrid will not send from unverified addresses. Complete this first, then use the verified email in sendEmail 'from' field.

updateWebhookUpdate webhook settings

sendCampaignSend campaign immediately

getWebhookGet specific webhook

createCampaignCreate marketing campaign

listCustomFields🔍 ESSENTIAL FIRST STEP: List all custom fields in your SendGrid account to get field IDs! Returns field IDs (like 'w1_D', 'w2_T') needed for addContact/updateContact. Always call this before using custom_fields in other operations!

listContactLists📋 ESSENTIAL DISCOVERY: List all contact lists in your SendGrid account to get list IDs! Returns list IDs needed for addContact list_ids, addContactsToList, etc. Always call this before working with contact lists!