SendGrid

List all configured alerts. Returns: All alerts with their types and settings.

Delete domain authentication. Args: - id: Domain ID Returns: Confirmation of deletion.

List all branded links. Branded links replace sendgrid.net tracking links with your domain. Returns: All branded links with their DNS records.

Get details of a branded link. Args: - id: Branded link ID Returns: Link details including DNS records.

List all sender identities. Args: - format: Response format Returns: All sender identities with verification status.

Send a single send immediately. Args: - id: Single send ID Returns: The triggered single send.

Delete a branded link. Args: - id: Branded link ID Returns: Confirmation of deletion.

List all IP addresses in your account. Returns: All IP addresses with their pools and warmup status.

Get details of a specific IP address. Args: - ip: IP address Returns: IP details including pools and warmup status.

List all IP pools. IP pools allow you to group IPs for different sending purposes. Returns: All IP pools with their assigned IPs.

Get details of an IP pool. Args: - name: Pool name Returns: Pool details with assigned IPs.

Create a new IP pool. Args: - name: Pool name Returns: The created pool.

Get details of a specific alert. Args: - id: Alert ID Returns: Alert details.

Create a new custom field for contacts. Args: - name: Field name (must be unique) - fieldType: Field type (Text, Number, or Date) Returns: The created custom field.

Create a new alert. Alert types: - stats_notification: Receive email stats at specified frequency - usage_limit: Alert when approaching credit limit Args: - type: Alert type ('stats_notification' or 'usage_limit') - emailTo: Email address to send alerts to - frequency: For stats alerts: 'daily', 'weekly', or 'monthly' - percentage: For usage alerts: percentage threshold (e.g., 90) Returns: The created alert.

Update an existing alert. Args: - id: Alert ID - emailTo: New recipient email - frequency: New frequency for stats alerts - percentage: New threshold for usage alerts Returns: The updated alert.

Delete an alert. Args: - id: Alert ID Returns: Confirmation of deletion.

List all API keys for the account. Note: The actual key values are not returned, only metadata. Args: - format: Response format Returns: List of API keys with their IDs, names, and scopes.

Get metadata for a specific API key. Args: - id: API key ID Returns: API key metadata (not the actual key value).

Create a new API key. IMPORTANT: The actual key value is only returned once during creation. Save it immediately! Common scopes include: - mail.send - alerts.create, alerts.read, alerts.update, alerts.delete - marketing.automation.create, marketing.automation.read, marketing.automation.update, marketing.automation.delete - stats.read - suppressions.create, suppressions.read, suppressions.update, suppressions.delete - templates.create, templates.read, templates.update, templates.delete - user.profile.read, user.profile.update Args: - name: Name for the API key - scopes: Array of permission scopes (optional, full access if not specified) Returns: The created API key including the actual key value (SAVE THIS!).

Update an API key's name and/or scopes. Args: - id: API key ID - name: New name for the key - scopes: New scopes (if provided, replaces all existing scopes) Returns: The updated API key.

Delete an API key. Warning: This action cannot be undone. Any applications using this key will lose access. Args: - id: API key ID Returns: Confirmation of deletion.

List contacts from SendGrid Marketing. Args: - pageToken: Token for pagination (optional) - format: Response format ('json' or 'markdown') Returns: Paginated list of contacts.

Get a single contact by ID. Args: - id: The contact ID - format: Response format Returns: The contact details.

Find a contact by email address. Args: - email: The email address to search for Returns: The contact if found, or null.

Add or update contacts in SendGrid Marketing. This is an upsert operation - existing contacts are updated, new contacts are created. Args: - contacts: Array of contact objects with email (required) and optional fields - listIds: Optional array of list IDs to add contacts to Returns: A job ID for tracking the import.

Delete contacts from SendGrid Marketing. Args: - ids: Array of contact IDs to delete - deleteAll: Set to true to delete ALL contacts (use with caution!) Returns: A job ID for tracking the deletion.

Search contacts using SGQL (SendGrid Query Language). Examples: - email LIKE '%@example.com%' - first_name = 'John' AND last_name = 'Doe' - created_at > '2024-01-01T00:00:00Z' Args: - query: SGQL query string - format: Response format Returns: Matching contacts.

Get the total number of contacts in your account. Returns: Contact count and billable count.

List all custom field definitions. Returns: All custom fields with their IDs, names, and types.

Update a custom field name. Args: - id: Field ID - name: New field name Returns: The updated custom field.

Delete a custom field. Warning: This will remove the field from all contacts. Args: - id: Field ID Returns: Confirmation of deletion.

List designs from the design library. Designs are reusable email templates that can be used with Single Sends. Args: - pageSize: Number of results (default 50) - pageToken: Pagination token - format: Response format Returns: Paginated list of designs.

Get a design by ID. Args: - id: Design ID - format: Response format Returns: Design details including HTML content.

Create a new design in the design library. Args: - name: Design name - subject: Email subject line - htmlContent: HTML email content - plainContent: Plain text content (optional) - generatePlainContent: Auto-generate plain text from HTML - editor: Editor type ('code' or 'design') - categories: Categories for organization Returns: The created design.

Update an existing design. Args: - id: Design ID - name: New name - subject: New subject line - htmlContent: New HTML content - plainContent: New plain text content - categories: New categories Returns: The updated design.

Delete a design from the library. Args: - id: Design ID Returns: Confirmation of deletion.

Duplicate an existing design. Args: - id: Design ID to duplicate - name: Name for the new design (optional) Returns: The duplicated design.

List all authenticated domains. Domain authentication (DKIM/SPF) improves deliverability and prevents spoofing. Returns: All authenticated domains with their DNS records and validation status.

Get details of an authenticated domain. Args: - id: Domain ID Returns: Domain details including DNS records to configure.

Start domain authentication process. This will generate DNS records that you need to add to your domain. Args: - domain: Domain to authenticate (e.g., example.com) - subdomain: Subdomain for DKIM (optional, defaults to em) - customSpf: Use custom SPF instead of SendGrid's - default: Set as the default sending domain - automaticSecurity: Enable automatic security (recommended) Returns: The domain with DNS records to configure.

Validate DNS records for an authenticated domain. Run this after adding DNS records to verify configuration. Args: - id: Domain ID Returns: Validation results for each DNS record.

Create a branded link. Args: - domain: Domain for branded links (e.g., link.example.com) - subdomain: Subdomain (optional) - default: Set as the default branded link Returns: The branded link with DNS records to configure.

Validate DNS records for a branded link. Args: - id: Branded link ID Returns: Validation results.

Rename an IP pool. Args: - name: Current pool name - newName: New pool name Returns: The updated pool.

Delete an IP pool. IPs in the pool will not be deleted, just removed from the pool. Args: - name: Pool name Returns: Confirmation of deletion.

Add an IP address to a pool. Args: - poolName: Pool name - ip: IP address to add Returns: Confirmation of addition.

Remove an IP address from a pool. Args: - poolName: Pool name - ip: IP address to remove Returns: Confirmation of removal.

List all IPs currently in warmup. Returns: IPs in warmup with their status.

Start the warmup process for an IP. Warmup gradually increases sending volume to build reputation. Args: - ip: IP address to warm up Returns: The IP with warmup status.

Stop the warmup process for an IP. Args: - ip: IP address Returns: Confirmation.

List all contact lists in SendGrid Marketing. Args: - format: Response format ('json' or 'markdown') Returns: All contact lists with their IDs, names, and contact counts.

Get details of a specific contact list. Args: - id: The list ID - format: Response format Returns: List details including contact count.

Create a new contact list. Args: - name: Name for the list (required) Returns: The created list.

Update a contact list name. Args: - id: List ID to update - name: New name for the list Returns: The updated list.

Delete a contact list. Args: - id: List ID to delete - deleteContacts: Also delete contacts that are only in this list Returns: Confirmation of deletion.

Get the number of contacts in a specific list. Args: - id: List ID Returns: Contact count and billable count for the list.

Add existing contacts to a list. Args: - listId: The list ID - contactIds: Array of contact IDs to add Returns: Job ID for tracking.

Remove contacts from a list (does not delete the contacts). Args: - listId: The list ID - contactIds: Array of contact IDs to remove Returns: Job ID for tracking.

Get a sender identity by ID. Args: - id: Sender ID - format: Response format Returns: Sender identity details.

Cancel a scheduled single send. Returns the single send to draft status. Args: - id: Single send ID Returns: Confirmation of cancellation.

Send an email using SendGrid. Args: - to: Array of recipient email addresses (required) - from: Sender email address (required) - fromName: Sender name (optional) - subject: Email subject line (required, unless using a template with subject) - text: Plain text email body (optional) - html: HTML email body (optional) - templateId: SendGrid template ID for dynamic templates (optional) - dynamicTemplateData: Data for template substitution (optional) - cc: Array of CC email addresses (optional) - bcc: Array of BCC email addresses (optional) - replyTo: Reply-to email address (optional) - categories: Array of categories for tracking (optional) - sendAt: Unix timestamp for scheduled sending (optional) - attachments: Array of attachments with base64 content (optional) Returns: Confirmation of email being accepted for delivery.

Send personalized emails to multiple recipients in a single API call. Each recipient can have their own substitution data for dynamic content. Args: - from: Sender email address (required) - fromName: Sender name (optional) - subject: Default email subject (can be overridden per recipient) - text: Plain text email body - html: HTML email body - templateId: SendGrid template ID - personalizations: Array of recipient customizations with to, cc, bcc, subject, dynamicTemplateData - categories: Tracking categories - sendAt: Unix timestamp for scheduled send Returns: Confirmation of batch email being accepted.

Create a batch ID for scheduling or canceling emails. Use this batch ID when sending emails to be able to cancel or pause them later. Returns: A unique batch ID to use with sendgrid_send_email's batchId parameter.

Validate that a batch ID exists and is valid. Args: - batchId: The batch ID to validate Returns: Whether the batch ID is valid.

List all scheduled sends that have been paused or cancelled. Returns: List of scheduled sends with their batch IDs and statuses.

Cancel a scheduled send by batch ID. Emails that have already been sent cannot be cancelled. Args: - batchId: The batch ID of the scheduled send Returns: Confirmation of cancellation.

Pause a scheduled send by batch ID. Args: - batchId: The batch ID of the scheduled send Returns: Confirmation of pause.

List all segments in SendGrid Marketing. Args: - parentListIds: Filter by parent list IDs (optional) - format: Response format Returns: All segments with their IDs, names, and contact counts.

Get details of a specific segment. Args: - id: Segment ID - format: Response format Returns: Segment details including query and contact count.

Create a new segment using SGQL query. Example queries: - email LIKE '%@example.com' - first_name = 'John' - created_at > '2024-01-01T00:00:00Z' - (first_name = 'John' OR first_name = 'Jane') AND last_name = 'Doe' Args: - name: Segment name - queryDsl: SGQL query defining the segment - parentListIds: Optional list IDs to scope the segment Returns: The created segment.

Update an existing segment. Args: - id: Segment ID - name: New name (optional) - queryDsl: New SGQL query (optional) Returns: The updated segment.

Delete a segment. Args: - id: Segment ID Returns: Confirmation of deletion.

Create a new sender identity. A verification email will be sent to the from address. Args: - nickname: Display name for the sender - fromEmail: From email address - fromName: From display name - replyToEmail: Reply-to email address (optional) - address: Physical address (required for CAN-SPAM compliance) - address2: Address line 2 - city: City - state: State/Province - zip: ZIP/Postal code - country: Country Returns: The created sender identity.

List email addresses that have reported emails as spam. Args: - startTime: Unix timestamp for start time - endTime: Unix timestamp for end time - limit: Number of results - offset: Pagination offset - format: Response format Returns: List of spam reports.

Update a sender identity. Args: - id: Sender ID - nickname: New nickname - fromName: New from display name - replyToEmail: New reply-to email - address: New address - city: New city - country: New country Returns: The updated sender identity.

Delete a sender identity. Args: - id: Sender ID Returns: Confirmation of deletion.

Resend the verification email for a sender identity. Args: - id: Sender ID Returns: Confirmation that verification email was sent.

List marketing single sends (campaigns). Args: - status: Filter by status ('draft', 'scheduled', 'triggered') - format: Response format Returns: List of single sends.

Get a single send by ID. Args: - id: Single send ID - format: Response format Returns: Single send details.

Create a new single send (marketing campaign). Args: - name: Campaign name - subject: Email subject - htmlContent: HTML email body - plainContent: Plain text body (optional, can be auto-generated) - senderId: Sender identity ID - listIds: List IDs to send to - segmentIds: Segment IDs to send to - sendToAll: Send to all contacts - categories: Tracking categories - suppressionGroupId: Unsubscribe group ID Returns: The created single send.

Update a single send. Args: - id: Single send ID - name: New name - subject: New subject - htmlContent: New HTML content - listIds: New list IDs - segmentIds: New segment IDs Returns: The updated single send.

Delete a single send. Args: - id: Single send ID Returns: Confirmation of deletion.

Schedule a single send for future delivery. Args: - id: Single send ID - sendAt: ISO 8601 datetime string Returns: The scheduled single send.

Get global email statistics. Args: - startDate: Start date (YYYY-MM-DD format, required) - endDate: End date (YYYY-MM-DD format, optional) - aggregatedBy: Aggregation period ('day', 'week', or 'month') - format: Response format Returns: Email statistics including requests, delivered, opens, clicks, bounces, etc.

Get email statistics by category. Categories are tags you assign when sending emails for tracking purposes. Args: - categories: Array of category names to get stats for - startDate: Start date (YYYY-MM-DD) - endDate: End date (YYYY-MM-DD, optional) - aggregatedBy: Aggregation period - format: Response format Returns: Statistics broken down by category.

Delete spam report records. Warning: Sending to addresses that reported spam may harm your sender reputation. Args: - emails: Array of email addresses to remove - deleteAll: Delete ALL spam reports Returns: Confirmation of deletion.

Get statistics by mailbox provider (Gmail, Yahoo, Outlook, etc.). Args: - startDate: Start date (YYYY-MM-DD) - endDate: End date (optional) - mailboxProviders: Filter to specific providers (optional) - format: Response format Returns: Statistics broken down by mailbox provider.

Get statistics by browser type for link clicks. Args: - startDate: Start date (YYYY-MM-DD) - endDate: End date (optional) - format: Response format Returns: Click statistics broken down by browser.

Get statistics by device type (desktop, phone, tablet, etc.). Args: - startDate: Start date (YYYY-MM-DD) - endDate: End date (optional) - format: Response format Returns: Statistics broken down by device type.

Get statistics by geographic location. Args: - startDate: Start date (YYYY-MM-DD) - endDate: End date (optional) - country: Filter to a specific country (optional) - format: Response format Returns: Statistics broken down by geography.

List all subusers. Subusers allow you to segment your email sending and statistics. Args: - limit: Number of results (default 500) - offset: Pagination offset Returns: List of subusers.

Get details of a subuser. Args: - username: Subuser username Returns: Subuser details.

Create a new subuser. Args: - username: Unique username - email: Email address for the subuser - password: Password (min 8 characters) - ips: Array of IP addresses to assign Returns: The created subuser.

Delete a subuser. Warning: This cannot be undone. Args: - username: Subuser username Returns: Confirmation of deletion.

Enable a disabled subuser. Args: - username: Subuser username Returns: Confirmation.

Disable a subuser (prevents sending). Args: - username: Subuser username Returns: Confirmation.

List email addresses that have bounced. Args: - startTime: Unix timestamp for start time filter - endTime: Unix timestamp for end time filter - limit: Number of results (default 500) - offset: Offset for pagination - format: Response format Returns: List of bounced email addresses with reasons.

Get bounce information for a specific email address. Args: - email: Email address to look up Returns: Bounce details if the email has bounced.

Delete bounce records to allow re-sending to those addresses. Args: - emails: Array of email addresses to remove from bounces - deleteAll: Delete ALL bounce records (use with caution!) Returns: Confirmation of deletion.

List email addresses that have been blocked. Blocks occur when the receiving server rejects the email (different from bounces). Args: - startTime: Unix timestamp for start time - endTime: Unix timestamp for end time - limit: Number of results - offset: Pagination offset - format: Response format Returns: List of blocked email addresses.

Delete block records. Args: - emails: Array of email addresses to remove from blocks - deleteAll: Delete ALL block records Returns: Confirmation of deletion.

List email addresses that are invalid. Args: - startTime: Unix timestamp for start time - endTime: Unix timestamp for end time - limit: Number of results - offset: Pagination offset - format: Response format Returns: List of invalid email addresses.

Delete invalid email records. Args: - emails: Array of email addresses to remove - deleteAll: Delete ALL invalid emails Returns: Confirmation of deletion.

List email addresses that have globally unsubscribed. These addresses will not receive any emails until removed. Args: - startTime: Unix timestamp for start time - endTime: Unix timestamp for end time - limit: Number of results - offset: Pagination offset - format: Response format Returns: List of globally unsubscribed addresses.

Add email addresses to the global unsubscribe list. Args: - emails: Array of email addresses to add Returns: Confirmation of addition.

Remove an email address from the global unsubscribe list. Args: - email: Email address to remove Returns: Confirmation of removal.

List all teammates on the account. Teammates are users who can access the SendGrid account with specific permissions. Args: - limit: Number of results - offset: Pagination offset Returns: List of teammates.

Get details of a teammate. Args: - username: Teammate username Returns: Teammate details including permissions.

Invite a new teammate to the account. Common scopes include: - mail.send - stats.read - suppressions.read, suppressions.update, suppressions.delete - templates.read, templates.create, templates.update, templates.delete - marketing.read, marketing.update - user.profile.read Args: - email: Email address to invite - scopes: Array of permission scopes - isAdmin: Grant admin access Returns: Invitation details.

Update a teammate's permissions. Args: - username: Teammate username - scopes: New permission scopes - isAdmin: Grant or revoke admin access Returns: The updated teammate.

Remove a teammate from the account. Args: - username: Teammate username Returns: Confirmation of removal.

List transactional templates. Args: - generations: Filter by template type ('legacy' or 'dynamic') - pageSize: Number of templates per page (default 50) - pageToken: Pagination token - format: Response format Returns: Paginated list of templates.

Get a template by ID with all versions. Args: - id: Template ID - format: Response format Returns: Template details including all versions.

Create a new transactional template. Args: - name: Template name - generation: Template type ('legacy' or 'dynamic', default 'dynamic') Returns: The created template (without versions).

Update a template name. Args: - id: Template ID - name: New template name Returns: The updated template.

Delete a template and all its versions. Args: - id: Template ID Returns: Confirmation of deletion.

Duplicate an existing template. Args: - id: Template ID to duplicate - name: Name for the new template (optional) Returns: The duplicated template.

Create a new version for a template. For dynamic templates, use Handlebars syntax for substitution: - {{variable}} for plain text - {{{variable}}} for HTML content - {{#if condition}}...{{/if}} for conditionals - {{#each array}}...{{/each}} for loops Args: - templateId: Parent template ID - name: Version name - subject: Email subject line (can include substitutions) - htmlContent: HTML email body - plainContent: Plain text email body - active: Set as active version (default true) - editor: Editor type ('code' or 'design') - generatePlainContent: Auto-generate plain text from HTML Returns: The created version.

Get a specific template version. Args: - templateId: Template ID - versionId: Version ID Returns: The template version with content.

Update a template version. Args: - templateId: Template ID - versionId: Version ID - name: New version name - subject: New subject line - htmlContent: New HTML content - plainContent: New plain text content - active: Set as active version Returns: The updated version.

Delete a template version. Args: - templateId: Template ID - versionId: Version ID Returns: Confirmation of deletion.

Activate a template version. The active version is used when sending emails with the template. Args: - templateId: Template ID - versionId: Version ID to activate Returns: The activated version.

List all unsubscribe groups (suppression groups). Unsubscribe groups allow recipients to opt out of specific types of emails. Args: - format: Response format Returns: All unsubscribe groups.

Get an unsubscribe group by ID. Args: - id: Group ID - format: Response format Returns: Group details.

Create a new unsubscribe group. Args: - name: Group name (shown to recipients) - description: Description (shown to recipients) - isDefault: Set as the default group Returns: The created group.

Update an unsubscribe group. Args: - id: Group ID - name: New name - description: New description Returns: The updated group.

Delete an unsubscribe group. Args: - id: Group ID Returns: Confirmation of deletion.

List email addresses that have unsubscribed from a specific group. Args: - groupId: Unsubscribe group ID Returns: List of email addresses.

Add email addresses to an unsubscribe group. Args: - groupId: Unsubscribe group ID - emails: Array of email addresses to add Returns: Confirmation of addition.

Remove an email from an unsubscribe group. Args: - groupId: Unsubscribe group ID - email: Email address to remove Returns: Confirmation of removal.

Search for all groups an email is suppressed from. Args: - email: Email address to search Returns: List of groups the email is suppressed from.

Validate an email address. Returns detailed information about the email's validity including: - Verdict (Valid, Risky, Invalid) - Score (0-1) - Domain validity - Syntax checks - Disposable address detection - Known bounce history Note: This feature requires SendGrid Email Validation to be enabled. Args: - email: Email address to validate - source: Source identifier for tracking (optional) Returns: Detailed validation results.

Get the current event webhook configuration. Event webhooks send real-time notifications about email events (delivered, opened, clicked, etc.). Returns: Current webhook configuration including URL and enabled events.

Update the event webhook configuration. Args: - enabled: Enable or disable the webhook - url: Webhook URL to receive events - delivered: Receive delivered events - open: Receive open events - click: Receive click events - bounce: Receive bounce events - deferred: Receive deferred events - dropped: Receive dropped events - spamReport: Receive spam report events - unsubscribe: Receive unsubscribe events - groupUnsubscribe: Receive group unsubscribe events - groupResubscribe: Receive group resubscribe events - processed: Receive processed events Returns: The updated webhook configuration.

Send a test event to the webhook URL. Args: - url: Webhook URL to test Returns: Confirmation that test was sent.

List all inbound parse webhook configurations. Inbound Parse allows you to receive emails and process them via webhook. Returns: All inbound parse configurations.

Get an inbound parse webhook by hostname. Args: - hostname: The hostname/domain configured for inbound parse Returns: Webhook configuration.

Create an inbound parse webhook. Note: You must configure MX records for the hostname to point to mx.sendgrid.net. Args: - hostname: Domain to receive emails on (e.g., parse.example.com) - url: Webhook URL to receive parsed emails - spamCheck: Check for spam before parsing - sendRaw: Send raw MIME message instead of parsed Returns: The created webhook configuration.

Update an inbound parse webhook. Args: - hostname: Hostname to update - url: New webhook URL - spamCheck: Enable spam check - sendRaw: Send raw MIME Returns: The updated webhook configuration.

Delete an inbound parse webhook. Args: - hostname: Hostname to delete Returns: Confirmation of deletion.