SendGrid

SendGrid Lists API

Twilio SendGrid Legacy Marketing Campaigns Contacts: Lists API

Documentation GitHub OpenAPI

Operations 17

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v3/contactdb/lists Create a legacy recipient list · Create a List #

Ask an LLM

“How do I create a new recipient list in the old contacts database?”

“Can I make a legacy recipient list with just a name?”

Tell an agent

Create a legacy recipient list called {name}.

Add a new contactdb recipient list named {name}.

GET /v3/contactdb/lists List all legacy recipient lists · Retrieve all lists #

Ask an LLM

“What recipient lists do I have in the legacy contacts database?”

“Does SendGrid return anything if I have no legacy recipient lists yet?”

Tell an agent

Show me every recipient list in my legacy contacts database.

List the legacy contactdb recipient lists on this account.

DELETE /v3/contactdb/lists Delete several legacy recipient lists · Delete Multiple lists #

Ask an LLM

“Can I delete several legacy recipient lists in one call?”

“Is there a bulk delete for old contactdb recipient lists?”

Tell an agent destructive · confirm first

Bulk delete multiple legacy recipient lists at once.

Remove a batch of contactdb recipient lists in a single request.

GET /v3/contactdb/lists/{list_id} Get one legacy recipient list · Retrieve a single list #

Ask an LLM

“How can I look up a single legacy recipient list by its ID?”

“What details come back for one contactdb recipient list?”

Tell an agent

Get legacy recipient list {list_id}.

Fetch the details of contactdb list {list_id}.

PATCH /v3/contactdb/lists/{list_id} Rename a legacy recipient list · Update a List #

Ask an LLM

“Can I rename one of my legacy recipient lists?”

“What can be changed on an existing contactdb list besides its name?”

Tell an agent

Rename legacy recipient list {list_id} to {name}.

Change the name of contactdb list {list_id} to {name}.

DELETE /v3/contactdb/lists/{list_id} Delete a legacy recipient list · Delete a List #

Ask an LLM

“If I delete a legacy recipient list, can the recipients on it be deleted too?”

“How do I remove one specific contactdb recipient list?”

Tell an agent destructive · confirm first

Delete legacy recipient list {list_id}.

Delete contactdb list {list_id} and also delete its contacts: {delete_contacts}.

GET /v3/contactdb/lists/{list_id}/recipients List recipients on a legacy list · Retrieve all recipients on a List #

Ask an LLM

“Who are the recipients on a given legacy recipient list?”

“Can I page through the recipients of a contactdb list?”

Tell an agent

Show the recipients on legacy list {list_id}.

Get page {page} of recipients on contactdb list {list_id}, {page_size} per page.

POST /v3/contactdb/lists/{list_id}/recipients Add many recipients to a legacy list · Add Multiple Recipients to a List #

Ask an LLM

“How do I put several existing recipients onto a legacy list at once?”

“What format do recipient IDs need when adding them in bulk to a contactdb list?”

Tell an agent

Add a batch of existing recipients to legacy list {list_id}.

Bulk add recipient IDs to contactdb list {list_id}.

POST /v3/contactdb/lists/{list_id}/recipients/{recipient_id} Add one recipient to a legacy list · Add a Single Recipient to a List #

Ask an LLM

“Can I add a single recipient to a legacy recipient list?”

“Which call adds just one contactdb recipient to one list?”

Tell an agent

Add recipient {recipient_id} to legacy list {list_id}.

Put contactdb recipient {recipient_id} on list {list_id}.

DELETE /v3/contactdb/lists/{list_id}/recipients/{recipient_id} Remove a recipient from a legacy list · Delete a Single Recipient from a Single List #

Ask an LLM

“How do I take one recipient off a legacy recipient list?”

“Can I drop a single contactdb recipient from just one list?”

Tell an agent destructive · confirm first

Remove recipient {recipient_id} from legacy list {list_id}.

Delete contactdb recipient {recipient_id} from list {list_id} only.

POST /v3/marketing/lists Create a Marketing Campaigns contact list · Create List #

Ask an LLM

“How do I create a new contact list for Marketing Campaigns?”

“Could a new marketing contact list be used to trigger an automation?”

Tell an agent

Create a marketing contact list named {name}.

Make a new Marketing Campaigns list called {name}.

GET /v3/marketing/lists List all Marketing Campaigns contact lists · Get All Lists #

Ask an LLM

“What contact lists do I have in Marketing Campaigns?”

“Can I page through my marketing contact lists with a page token?”

Tell an agent

List all my Marketing Campaigns contact lists.

Get my marketing contact lists, {page_size} per page.

GET /v3/marketing/lists/{id} Get a Marketing Campaigns contact list · Get a List by ID #

Ask an LLM

“Can I see a sample of the most recent contacts on a marketing list?”

“What does SendGrid return about a single marketing contact list?”

Tell an agent

Get marketing contact list {id}.

Show marketing list {id} with a contact sample: {contact_sample}.

PATCH /v3/marketing/lists/{id} Rename a Marketing Campaigns contact list · Update List #

Ask an LLM

“Can I change the name of a marketing contact list?”

“Is renaming the only update allowed on a Marketing Campaigns list?”

Tell an agent

Rename marketing contact list {id} to {name}.

Update the name of Marketing Campaigns list {id} to {name}.

DELETE /v3/marketing/lists/{id} Delete a Marketing Campaigns contact list · Delete a list #

Ask an LLM

“When I delete a marketing contact list, are the contacts on it deleted as well?”

“How do I remove a Marketing Campaigns list I no longer use?”

Tell an agent destructive · confirm first

Delete marketing contact list {id}.

Delete marketing list {id} and its contacts too: {delete_contacts}.

DELETE /v3/marketing/lists/{id}/contacts Remove contacts from a marketing list · Remove Contacts from a List #

Ask an LLM

“Can I take contacts off a marketing list without deleting the contacts themselves?”

“How do I remove specific contact IDs from one Marketing Campaigns list?”

Tell an agent destructive · confirm first

Remove contacts {contact_ids} from marketing list {id}.

Take contact IDs {contact_ids} out of list {id} but keep the contacts.

GET /v3/marketing/lists/{id}/contacts/count Count contacts on a marketing list · Get List Contact Count #

Ask an LLM

“How many contacts are on one of my marketing lists?”

“Is there a quick way to get just the contact count for a list?”

Tell an agent

Count the contacts on marketing list {id}.

Tell me how many contacts list {id} holds.

SendGrid Lists API

Operations 17

Documentation

Specifications

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification