> This page is for Workforce. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. # SendGrid **Authentication:** API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow. ## Sample use cases * Pull bounce and click rates for the last campaign sent. * Send the `Welcome` template to the contacts in this CSV with their first name prefilled. * Find email addresses on the suppression list added in the last 30 days. ## Available Tools #### list_api_keys List all API keys in your SendGrid account. Does not include the actual key values. #### get_api_key Get details of a specific API key by ID. Does not return the actual key value. #### create_api_key Create a new API key with specified scopes. IMPORTANT: The key value is only shown once on creation. #### update_api_key Update an API key's name or scopes. #### delete_api_key Delete an API key. This action is irreversible. #### send_email Send an email via SendGrid. Supports plain text, HTML, templates, attachments, and batch sending with personalizations. #### send_simple_email Send a simple email with just recipient, sender, subject, and text/HTML content. For more advanced options, use send_email. #### send_template_email Send an email using a SendGrid dynamic template with personalization data. #### list_verified_senders List all verified sender identities in your SendGrid account. #### create_verified_sender Create a new verified sender identity. A verification email will be sent to the address. #### update_verified_sender Update a verified sender's details. #### delete_verified_sender Delete a verified sender identity. #### resend_verification_email Resend the verification email for a pending verified sender. #### list_authenticated_domains List all authenticated domains for email sending. Authenticated domains improve deliverability. #### get_authenticated_domain Get details of a specific authenticated domain including DNS records. #### authenticate_domain Add a new domain for authentication. Returns DNS records to configure with your DNS provider. #### validate_authenticated_domain Validate that DNS records are properly configured for a domain. #### delete_authenticated_domain Delete an authenticated domain from your SendGrid account. #### get_global_stats Get global email statistics including sends, opens, clicks, bounces, and unsubscribes for a date range. #### get_category_stats Get email statistics filtered by categories for a date range. #### get_geo_stats Get geographic email statistics showing opens and clicks by country. #### get_mailbox_provider_stats Get email statistics by mailbox provider (Gmail, Outlook, Yahoo, etc.). #### get_browser_stats Get email click statistics by browser type. #### get_device_stats Get email open statistics by device type (desktop, mobile, tablet, webmail). #### list_bounces List all bounced email addresses. Bounces occur when an email cannot be delivered to the recipient. #### get_bounce Get bounce information for a specific email address. #### delete_bounce Delete a single bounce record by email address, allowing future sends to that address. #### delete_bounces Delete multiple bounce records by email or delete all bounces. #### list_blocks List all blocked email addresses. Blocks occur when the recipient server rejects your email. #### get_block Get block information for a specific email address. #### delete_block Delete a single block record by email address. #### delete_blocks Delete multiple block records by email or delete all blocks. #### list_spam_reports List all spam reports. Spam reports are filed when recipients mark your email as spam. #### get_spam_report Get spam report information for a specific email address. #### delete_spam_report Delete a single spam report by email address. #### delete_spam_reports Delete multiple spam reports by email or delete all spam reports. #### list_global_unsubscribes List all globally unsubscribed email addresses. These addresses will not receive any emails. #### add_global_unsubscribes Add email addresses to the global unsubscribe list. These addresses will not receive any emails. #### delete_global_unsubscribe Remove an email address from the global unsubscribe list, allowing emails to be sent again. #### list_suppression_groups List all suppression groups. Suppression groups allow recipients to unsubscribe from specific types of emails. #### get_suppression_group Get details of a specific suppression group by ID. #### create_suppression_group Create a new suppression group for managing email preferences. #### update_suppression_group Update a suppression group's name, description, or default status. #### delete_suppression_group Delete a suppression group. Cannot delete groups with active suppressions. #### list_group_suppressions List all email addresses suppressed in a specific group. #### add_group_suppression Add email addresses to a suppression group, preventing them from receiving that type of email. #### delete_group_suppression Remove an email address from a suppression group. #### list_templates List all transactional email templates in SendGrid. #### get_template Get a transactional template by ID with all its versions. #### create_template Create a new transactional email template. #### update_template Update a transactional template name. #### delete_template Delete a transactional template and all its versions. #### create_template_version Create a new version of an existing template with HTML/text content. #### get_template_version Get a specific template version by ID. #### update_template_version Update a template version content, subject, or active status. #### delete_template_version Delete a specific template version. #### activate_template_version Activate a specific template version to be used when sending emails.