canonical: https://jentic.com/apis/sendgrid.com

# Twilio SendGrid APIs

Twilio SendGrid is an email delivery platform whose APIs cover transactional and marketing email sending, contact and list management, deliverability infrastructure, analytics, and account administration. The portfolio lets an agent send mail at scale over HTTP, build and target marketing campaigns, authenticate sending domains and IP addresses, track opens and clicks, manage suppressions, and administer users and API keys, all against a single SendGrid account.

## For AI agents

An agent can send transactional and marketing email, manage contacts, lists, and segments, schedule and cancel batch sends, and configure deliverability settings such as domain authentication, link branding, and dedicated IP warmup. It can also pull delivery and engagement statistics, manage suppressions and tracking, and administer API keys, teammates, subusers, and single sign-on across the account.

## Scope

Use for: Sending transactional and marketing email at scale, managing contacts, lists, and segments, configuring deliverability infrastructure, and reporting on email engagement through Twilio SendGrid

Not supported:
- SMS messaging
- voice calling
- push notifications
- inbound email hosting
- payment processing

## APIs

| API | Category | Endpoints | Description |
| --- | --- | --- | --- |
| Twilio SendGrid Legacy Marketing Campaigns Contacts API | marketing | 36 | Programmatically create a custom field, retrieve all custom fields. |
| Twilio SendGrid Suppressions API | communications | 33 | Programmatically create a new suppression group, retrieve all suppression groups associated with the user.. |
| Twilio SendGrid Webhook Configuration API | developer-tools | 19 | Programmatically create a new event webhook, retrieve all of your event webhooks.. |
| Twilio SendGrid Domain Authentication API | communications | 16 | Programmatically email dns records to a co-worker, authenticate a domain. |
| Twilio SendGrid IP Address Management API | productivity | 15 | Programmatically add a twilio sendgrid ip address, get a list of all ip addresses on your account. |
| Twilio SendGrid Marketing Campaigns Contacts API | marketing | 15 | Programmatically get sample contacts, add or update a contact. |
| Twilio SendGrid Subusers | payments | 14 | Programmatically create subuser, list all subusers. |
| Twilio SendGrid Mail Settings API | communications | 13 | Programmatically retrieve all mail settings, retrieve address whitelist mail settings. |
| Twilio SendGrid IP Address API | communications | 12 | Programmatically add ips, retrieve all ip addresses. |
| Twilio SendGrid Single Sign-On API | identity-auth | 12 | Programmatically create an sso certificate, get an sso certificate. |
| Twilio SendGrid Legacy Marketing Campaigns Campaigns API | communications | 11 | Programmatically create a campaign, retrieve all campaigns. |
| Twilio SendGrid Marketing Campaigns Single Sends API | marketing | 11 | Programmatically create single send, get all single sends. |
| Twilio SendGrid Templates API | communications | 11 | Programmatically create a transactional template., retrieve paged transactional templates.. |
| Twilio SendGrid Link Branding API | communications | 10 | Programmatically create a branded link, retrieve all branded links. |
| Twilio SendGrid Statistics API | analytics | 10 | Programmatically retrieve email statistics by browser., retrieve all categories. |
| Twilio SendGrid Account Provisioning API | developer-tools | 9 | Programmatically create an account, get all accounts. |
| Twilio SendGrid Marketing Campaigns Designs | marketing | 9 | Programmatically create design, list designs. |
| Twilio SendGrid Teammates API | identity-auth | 9 | Programmatically invite teammate, retrieve all teammates. |
| Twilio SendGrid Tracking Settings API | communications | 9 | Programmatically retrieve tracking settings, retrieve click track settings. |
| Twilio SendGrid User API | social-media | 9 | Programmatically get a user's account information., retrieve your credit balance. |
| Twilio SendGrid Marketing Campaigns Statistics API | analytics | 8 | Programmatically get all automation stats, get automation stats by id. |
| Twilio SendGrid Verified Senders API | communications | 8 | Programmatically create verified sender request, get all verified senders. |
| Twilio SendGrid Marketing Campaigns Lists API | marketing | 7 | Programmatically create list, get all lists. |
| Twilio SendGrid API Keys API | communications | 6 | Programmatically create API keys, retrieve all API keys belonging to the authenticated user. |
| Twilio SendGrid IP Access Management API | e-commerce | 6 | Programmatically retrieve all recent access attempts, add one or more ips to the allow list. |
| Twilio SendGrid Legacy Marketing Campaigns Sender Identities API | marketing | 6 | Programmatically create a sender identity, get all sender identities. |
| Twilio SendGrid Marketing Campaigns Segments 2.0 API | marketing | 6 | Programmatically create segment, get list of segments. |
| Twilio SendGrid Marketing Campaigns Senders API | marketing | 6 | Programmatically create a sender, get a list of all senders. |
| Twilio SendGrid Alerts API | communications | 5 | Programmatically create a new alert, retrieve all alerts. |
| Twilio SendGrid Integrations API | crm | 5 | Programmatically createintegration, listintegration. |
| Twilio SendGrid Reverse DNS API | communications | 5 | Programmatically set up reverse dns, retrieve all reverse dns records. |
| Twilio SendGrid Scheduled Sends API | productivity | 5 | Programmatically cancel or pause a scheduled send, retrieve all scheduled sends. |
| Twilio SendGrid Email Activity API | communications | 4 | Programmatically filter all messages, filter messages by message id. |
| Twilio SendGrid Email Address Validation API | communications | 4 | Programmatically validate an email, this request lists all of a user's bulk email validation jobs.. |
| Twilio SendGrid IP Warmup API | communications | 4 | Programmatically start warming up an ip address, retrieve all ips currently in warmup. |
| Twilio SendGrid Marketing Campaigns Custom Fields API | marketing | 4 | Programmatically create custom field definition, get all field definitions. |
| Twilio SendGrid Scopes API | identity-auth | 4 | Programmatically retrieve a list of scopes for which this user has access., retrieve access requests. |
| Twilio SendGrid Mail API | communications | 3 | Send emails at scale via HTTP, manage batch sends, and track delivery with open and click analytics. |
| Twilio SendGrid Marketing Campaigns Segments API | marketing | 3 | Programmatically get list of segments, get segment by id. |
| Twilio SendGrid Enforced TLS API | communications | 2 | Programmatically retrieve current enforced tls settings., update enforced tls settings. |
| Twilio SendGrid Engagement Quality API | communications | 2 | Programmatically get engagement quality scores, get subusers' engagement quality scores. |
| Twilio SendGrid Marketing Campaigns Send Test Email API | marketing | 1 | Programmatically send a test marketing email. |
| Twilio SendGrid Partner API | e-commerce | 1 | Programmatically returns a list of all partner settings.. |
| Twilio SendGrid Recipients' Data Erasure API | communications | 1 | Programmatically erase recipients' email data. |

## Which API to use

| Need | API | Why |
| --- | --- | --- |
| Send a one-off transactional or marketing email over HTTP | mail | Core send endpoint with templates, categories, batch scheduling, and open/click tracking |
| Create and send a one-time campaign to a list or segment | mc-singlesends | Single Sends are non-automated one-time campaign messages to an audience |
| Send a test marketing email before a real campaign | mc-test | Sends a marketing email to up to 10 addresses for layout and content checks |
| Manage marketing contacts in current Marketing Campaigns | mc-contacts | Current Contacts API for importing, updating, and deleting marketing contacts |
| Manage marketing contacts on the older stack | lmc-contactdb | Legacy Marketing Campaigns contacts and custom fields for accounts still on that version |
| Define dynamic audience segments | mc-segments-2.0 | Segments V2 update dynamically as contact data changes; the older mc-segments is read-only after deprecation |
| Manage the sending From identity | verified-senders | Verified Senders authorizes individual From addresses without full domain authentication |
| Add and manage dedicated IP addresses | ip-address-management | Combines the older IP Address and IP Pools functionality into one current API |
| Retrieve overall email program statistics | stats | Account-wide stats by category, browser, and mailbox provider |
| Retrieve campaign-level statistics | mc-stats | Stats scoped to Automations and Single Sends rather than the whole account |

## Cross-API use cases

### Send a tracked transactional email with a saved template

An agent creates a reusable transactional template, then sends mail referencing that template ID and reads back open and click statistics to measure engagement.

Example prompt: Create a transactional template, send an email that references its template ID, then retrieve open and click stats for the send.

### Warm a dedicated IP on an authenticated domain

An agent authenticates a sending domain, adds a dedicated IP address, and starts a gradual warmup schedule to build sender reputation before high-volume sending.

Example prompt: Authenticate a domain, add a dedicated IP, then start warming that IP on the recommended schedule.

### Build and launch a targeted marketing campaign

An agent adds contacts, groups them into a dynamic segment, and creates a Single Send targeting that segment for a one-time campaign.

Example prompt: Add or update contacts, create a dynamic segment from their attributes, then create a Single Send addressed to that segment.

### Manage recipient consent and receive delivery events

An agent maintains suppression groups so unsubscribed recipients are filtered, and configures an event webhook to consume delivery and engagement events in near real time.

Example prompt: Create a suppression group for opt-outs, then configure an event webhook to receive delivery and engagement events.

## Why Jentic

- **Setup:** Once Jentic One is installed, you or your agent can find and add any Twilio SendGrid API from the Jentic directory to your workspace, so sending, marketing, deliverability, and reporting endpoints are all reachable through one consistent interface.
- **Permission scoping:** Your own rules in your Jentic One instance decide which SendGrid operations an agent may call, so you can allow read-only stats or contact lookups while withholding destructive actions like erasing recipient data or deleting API keys.
- **Credential handling:** Your single SendGrid API key is stored encrypted in your own self-hosted Jentic One instance and injected as the bearer token at call time, so the agent triggers SendGrid operations without reading the raw key.
- **Discovery method:** An agent searches the Jentic API Directory for the SendGrid capability it needs, such as sending mail or building a segment, and loads the matching operation on demand instead of hardcoding endpoints across the portfolio.

## Related vendors

- **Mailgun** — Alternative transactional and marketing email delivery API with analytics and validation
- **Postmark** — Transactional email delivery with templates and delivery tracking
- **Mailchimp** — Marketing email, audience segmentation, and campaign management
- **Twilio** — Parent company's messaging APIs for SMS, voice, and other channels alongside email

## FAQ

### What can an agent do across the Twilio SendGrid APIs?

An agent can send transactional and marketing email over HTTP, build and target campaigns with contacts, lists, and segments, configure deliverability infrastructure such as domain authentication, link branding, and dedicated IP warmup, and pull delivery and engagement statistics. It can also administer the account by managing API keys, teammates, subusers, single sign-on, and suppressions.

### Do all these APIs share one credential?

Yes. Every Twilio SendGrid API authenticates with a single SendGrid API key sent as a bearer token, so one credential works across sending, marketing, deliverability, analytics, and administration. What each key can actually do is bounded by the scopes assigned to it.

### What is the difference between the Mail API and Marketing Campaigns Single Sends?

The Mail API sends individual transactional or marketing messages over HTTP, with support for templates, categories, and batch scheduling. Single Sends are one-time, non-automated campaign messages delivered to a list or segment of your marketing audience, and they carry their own campaign statistics.

### Why are there both current and legacy Marketing Campaigns APIs?

SendGrid maintains a current Marketing Campaigns stack (Contacts, Lists, Segments V2, Single Sends, Designs, Senders) and an older legacy stack still used by some accounts. The legacy Contacts, Campaigns, and Sender Identities APIs remain operational, but new work should target the current versions where possible.

### How do these APIs help with email deliverability?

Several APIs focus on reputation and inbox placement: domain authentication and reverse DNS establish sender trust, link branding serves tracked links from your own domain, dedicated IP management and IP warmup build a sending reputation gradually, and the engagement quality API reports a score correlated with deliverability.

### Can an agent track and report on email performance?

Yes. The Statistics API returns account-wide metrics by category, browser, and mailbox provider, while the Marketing Campaigns Statistics API scopes results to Automations and Single Sends. The Email Activity API lets an agent query and download data about individual stored messages.

### How does an agent manage recipient consent and privacy?

The Suppressions API manages unsubscribe and suppression groups so opted-out recipients are filtered from sends, and the Recipients' Data Erasure API deletes a recipient's personal data to support data privacy obligations. Tracking settings control which interactions are recorded.