List all marketing automations

Get detailed information about a specific automation including all steps and settings

Update automation-level settings such as name, status, and title. Use this to activate/pause entire automations or rename them.

Update individual step settings within an automation, including step status (activate/pause), wait time, and send configurations

Permanently delete a marketing automation. This action cannot be undone.

Open SendGrid automation creator in browser

Open automation editor for a specific automation

List all single send campaigns

Get detailed content and settings for a single send campaign

Open SendGrid single send creator in browser

Open single send stats page for a specific campaign

List all email lists

Create a new email list in your SendGrid account

Update the properties of an existing email list

Delete an existing email list from your SendGrid account

List all segments with their parent list relationships

Open SendGrid segment creator in browser

Create new contacts in your SendGrid account

Create new contacts and assign them to specific email lists

Open SendGrid CSV contact upload page in browser

List all custom fields

Create a new custom field for contacts

Update an existing custom field definition

Delete a custom field definition

List all verified senders

Create a new sender identity

Delete contacts by IDs

Remove contacts from a specific email list

Get detailed information about a specific contact by ID

Update existing contact information

Search for contacts using query conditions without creating a segment. Only the first 50 matching contacts are returned — this endpoint does not support pagination.

Search for specific contacts by their email addresses

List up to 50 of your most recently uploaded/updated contacts, sorted by email address. This endpoint takes no parameters — SendGrid deprecated pagination here; use search_contacts or export for anything beyond a quick sample.

Delete a verified sender identity

Update an existing segment's name or query criteria

Delete an existing segment

Send an email using SendGrid Mail Send API

Get available permission scopes for API keys

Retrieve global email statistics for your SendGrid account

Retrieve email statistics grouped by browser type. Only clicks and unique_clicks metrics are available.

Retrieve email statistics grouped by email client type (desktop, mobile, webmail). Only opens and unique_opens metrics are available. This endpoint does not support filtering or pagination.

Retrieve email statistics grouped by device type (desktop, mobile, tablet). Only opens and unique_opens metrics are available.

Retrieve email statistics grouped by country. Only clicks, unique_clicks, opens, and unique_opens metrics are available. Filtering is by country only (no state/province filter exists).

Retrieve email statistics grouped by mailbox provider (Gmail, Outlook, Yahoo, etc.). Broadest metric set of all stats breakdowns: blocks, bounces, clicks, deferred, delivered, drops, opens, processed, requests, spam_reports, unique_clicks, unique_opens. Note: no unsubscribes metric.

Retrieve email statistics for specific categories (available for previous 13 months only)

Retrieve email statistics for specific subusers

Get a comprehensive overview of email statistics across multiple dimensions

Retrieve all transactional templates (legacy and dynamic)

Retrieve details of a specific template including all versions

Create a new dynamic transactional template

Update the name of an existing template

Delete a template and all its versions

Create a new version of a template with HTML content and settings

Retrieve details of a specific template version

Update the content and settings of a template version

Delete a specific version of a template

Create a new template with HTML content in one step - perfect for AI-generated designs

Open the SendGrid template editor in browser for visual editing