# Twilio SendGrid Subusers API

> Twilio SendGrid Subusers API on Apizie: 14 endpoints (List all Subusers, Create Subuser, Enable/disable a subuser, Delete a subuser, …) 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://zieapi.vercel.app/v1/communication:sendgrid-subusers-v3/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `communication:sendgrid-subusers-v3`
- Category: Communication
- Status: byok
- Source: https://www.twilio.com/docs/sendgrid/api-reference
- Page: https://zieapi.vercel.app/api/communication/sendgrid-subusers-v3
- OpenAPI: https://zieapi.vercel.app/api/communication/sendgrid-subusers-v3/openapi.json

The Twilio SendGrid Subusers API allows you to create and manage your Subuser accounts. Subusers are available on [Pro and Premier plans](https://sendgrid.com/pricing), and you can think of them as sub-accounts. Each…

## Endpoints

### List all Subusers
`GET https://zieapi.vercel.app/v1/communication:sendgrid-subusers-v3/list-subuser` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | no | The username of this subuser. |
| limit | integer | no | `limit` sets the page size, i.e. maximum number of items from the list to be returned for a single API request. If omitted, the default… |
| region | string | no | Filter for Subusers in this region. If not provided, all Subusers will be returned. All users can also be explicitly requested by using… |
| include_region | boolean | no | Optional flag to include the regions of the Subusers in the response. If not provided, the region will be omitted from the response. |
| offset | integer | no | The number of items in the list to skip over before starting to retrieve the items for the requested page. The default `offset` of `0`… |

### Create Subuser
`POST https://zieapi.vercel.app/v1/communication:sendgrid-subusers-v3/create-subuser` (byok)

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

### Enable/disable a subuser
`POST https://zieapi.vercel.app/v1/communication:sendgrid-subusers-v3/update-subuser` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| subuser_name | string | yes | The username of the Subuser. |
| body | object | no | JSON request body |

### Delete a subuser
`POST https://zieapi.vercel.app/v1/communication:sendgrid-subusers-v3/delete-subuser` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| subuser_name | string | yes | The username of the Subuser. |

### Enable/Disable website access for a Subuser
`POST https://zieapi.vercel.app/v1/communication:sendgrid-subusers-v3/update-subuser-website-access` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| subuser_name | string | yes |  |
| body | object | no | JSON request body |

### Get the Credits for a Subuser
`GET https://zieapi.vercel.app/v1/communication:sendgrid-subusers-v3/get-subuser-credit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| subuser_name | string | yes | The username of the Subuser. |

### Update the Credits for a Subuser
`POST https://zieapi.vercel.app/v1/communication:sendgrid-subusers-v3/update-subuser-credit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| subuser_name | string | yes | The username of the Subuser. |
| body | object | yes | JSON request body |

### Update the remaining credits for a Subuser
`POST https://zieapi.vercel.app/v1/communication:sendgrid-subusers-v3/update-subuser-remaining-credit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| subuser_name | string | yes | The username of the Subuser. |
| body | object | yes | JSON request body |

### Update IPs assigned to a subuser
`POST https://zieapi.vercel.app/v1/communication:sendgrid-subusers-v3/update-subuser-ip` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| subuser_name | string | yes | The username of the Subuser. |
| body | object | no | JSON request body |

### Retrieve the monthly email statistics for a single subuser
`GET https://zieapi.vercel.app/v1/communication:sendgrid-subusers-v3/list-subuser-monthly-stat` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| subuser_name | string | yes | The username of the Subuser. |
| date | string | yes | The date of the month to retrieve statistics for. Must be formatted YYYY-MM-DD |
| sort_by_metric | string | no | The metric that you want to sort by. Metrics that you can sort by are: `blocks`, `bounces`, `clicks`, `delivered`, `opens`, `requests`,… |
| sort_by_direction | string | no | The direction you want to sort. |
| limit | integer | no | Optional field to limit the number of results returned. |
| offset | integer | no | Optional beginning point in the list to retrieve from. |

### Retrieve Subuser Reputations
`GET https://zieapi.vercel.app/v1/communication:sendgrid-subusers-v3/list-reputation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| usernames | string | no |  |

### Retrieve email statistics for your subusers.
`GET https://zieapi.vercel.app/v1/communication:sendgrid-subusers-v3/list-stat` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | no | Limits the number of results returned per page. |
| offset | integer | no | The point in the list to begin retrieving results from. |
| aggregated_by | string | no | How to group the statistics. Must be either "day", "week", or "month". |
| subusers | string | yes | The subuser you want to retrieve statistics for. You may include this parameter up to 10 times to retrieve statistics for multiple subusers. |
| start_date | string | yes | The starting date of the statistics to retrieve. Must follow format YYYY-MM-DD. |
| end_date | string | no | The end date of the statistics to retrieve. Defaults to today. |

### Retrieve monthly stats for all subusers
`GET https://zieapi.vercel.app/v1/communication:sendgrid-subusers-v3/list-monthly-stat` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| date | string | yes | The date of the month to retrieve statistics for. Must be formatted YYYY-MM-DD |
| subuser | string | no | A substring search of your subusers. |
| sort_by_metric | string | no | The metric that you want to sort by. Metrics that you can sort by are: `blocks`, `bounces`, `clicks`, `delivered`, `opens`, `requests`,… |
| sort_by_direction | string | no | The direction you want to sort. |
| limit | integer | no | Optional field to limit the number of results returned. |
| offset | integer | no | Optional beginning point in the list to retrieve from. |

### Retrieve the totals for each email statistic metric for all subusers.
`GET https://zieapi.vercel.app/v1/communication:sendgrid-subusers-v3/list-stat-sum` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| sort_by_direction | string | no | The direction you want to sort. |
| start_date | string | yes | The starting date of the statistics to retrieve. Must follow format YYYY-MM-DD. |
| end_date | string | no | The end date of the statistics to retrieve. Defaults to today. Must follow format YYYY-MM-DD. |
| limit | integer | no | Limits the number of results returned per page. |
| offset | integer | no | The point in the list to begin retrieving results from. |
| aggregated_by | string | no | How to group the statistics. Defaults to today. Must follow format YYYY-MM-DD. |
| sort_by_metric | string | no | The metric that you want to sort by. Must be a single metric. |

## Example
```
curl "https://zieapi.vercel.app/v1/communication:sendgrid-subusers-v3/list-subuser" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Twilio SendGrid Subusers API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/communication:sendgrid-subusers-v3/list-subuser with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Twilio SendGrid Subusers API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key communication:sendgrid-subusers-v3.

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