# Twilio SendGrid Marketing Campaigns Lists API API

> Twilio SendGrid Marketing Campaigns Lists API API on Apizie: 7 endpoints (Get All Lists, Create List, Get a List by ID, Update List, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/communication:sendgrid-mc-lists-v3/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `communication:sendgrid-mc-lists-v3`
- Category: Communication
- Status: byok
- Source: https://www.twilio.com/docs/sendgrid/api-reference
- Page: https://apizie.tech/api/communication/sendgrid-mc-lists-v3
- OpenAPI: https://apizie.tech/api/communication/sendgrid-mc-lists-v3/openapi.json

The Twilio SendGrid Marketing Campaigns Lists API allows you to manage your contacts lists programmatically. Lists are static collections of Marketing Campaigns contacts. You can use this API to interact with the list…

## Endpoints

### Get All Lists
`GET https://apizie.tech/v1/communication:sendgrid-mc-lists-v3/list-marketing-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page_size | number | no | Maximum number of elements to return. Defaults to 100, returns 1000 max |
| page_token | string | no |  |

### Create List
`POST https://apizie.tech/v1/communication:sendgrid-mc-lists-v3/create-marketing-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Get a List by ID
`GET https://apizie.tech/v1/communication:sendgrid-mc-lists-v3/get-marketing-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the list on which you want to perform the operation. |
| contact_sample | boolean | no | Setting this parameter to the true will cause the contact_sample to be returned |

### Update List
`POST https://apizie.tech/v1/communication:sendgrid-mc-lists-v3/update-marketing-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the list on which you want to perform the operation. |
| body | object | no | JSON request body |

### Delete a list
`POST https://apizie.tech/v1/communication:sendgrid-mc-lists-v3/delete-marketing-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the list on which you want to perform the operation. |
| delete_contacts | boolean | no | Flag indicates that all contacts on the list are also to be deleted. |

### Remove Contacts from a List
`POST https://apizie.tech/v1/communication:sendgrid-mc-lists-v3/delete-contact` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the list on which you want to perform the operation. |
| contact_ids | string | yes | Comma separated list of contact IDs that you want to remove from the specified contacts list. |

### Get List Contact Count
`GET https://apizie.tech/v1/communication:sendgrid-mc-lists-v3/list-contact-count` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

## Example
```
curl "https://apizie.tech/v1/communication:sendgrid-mc-lists-v3/list-marketing-list" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Twilio SendGrid Marketing Campaigns Lists API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/communication:sendgrid-mc-lists-v3/list-marketing-list with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Twilio SendGrid Marketing Campaigns Lists API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Twilio SendGrid Marketing Campaigns Lists API itself also needs your own key from sendgrid.com.

### Can AI agents use the Twilio SendGrid Marketing Campaigns Lists API API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key communication:sendgrid-mc-lists-v3.

### What is the status of the Twilio SendGrid Marketing Campaigns Lists API API?
Needs your own provider key (bring your own key)