# Twilio SendGrid Suppressions API API

> Twilio SendGrid Suppressions API API on Apizie: 33 endpoints (Retrieve all suppression groups associated with the user., Create a new suppression group, Get information on a single suppression group., Update a suppression group., …) 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-suppressions-v3/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

The Twilio SendGrid Suppressions API allows you to manage your Suppressions or Unsubscribes and Suppression or Unsubscribe groups. With SendGrid, an unsubscribe is the action an email recipient takes when they opt-out…

## Endpoints

### Retrieve all suppression groups associated with the user.
`GET https://apizie.tech/v1/communication:sendgrid-suppressions-v3/list-asm-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | integer | no | The ID of the suppression group(s) you want to retrieve. |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Create a new suppression group
`POST https://apizie.tech/v1/communication:sendgrid-suppressions-v3/creat-asm-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |
| body | object | no | JSON request body |

### Get information on a single suppression group.
`GET https://apizie.tech/v1/communication:sendgrid-suppressions-v3/get-asm-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| group_id | string | yes | The ID of the suppression group you would like to retrieve. |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Update a suppression group.
`POST https://apizie.tech/v1/communication:sendgrid-suppressions-v3/update-asm-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| group_id | string | yes | The ID of the suppression group you would like to retrieve. |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |
| body | object | no | JSON request body |

### Delete a Suppression Group
`POST https://apizie.tech/v1/communication:sendgrid-suppressions-v3/delete-asm-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| group_id | string | yes | The ID of the suppression group you would like to retrieve. |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Retrieve all suppressions for a suppression group
`GET https://apizie.tech/v1/communication:sendgrid-suppressions-v3/list-suppression-from-asm-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| group_id | string | yes | The id of the unsubscribe group that you are adding suppressions to. |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Add suppressions to a suppression group
`POST https://apizie.tech/v1/communication:sendgrid-suppressions-v3/add-suppression-to-asm-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| group_id | string | yes | The id of the unsubscribe group that you are adding suppressions to. |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |
| body | object | no | JSON request body |

### Delete a suppression from a suppression group
`POST https://apizie.tech/v1/communication:sendgrid-suppressions-v3/delete-suppression-from-asm-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| group_id | string | yes | The id of the suppression group that you are removing an email address from. |
| email | string | yes | The email address that you want to remove from the suppression group. |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Search for suppressions within a group
`POST https://apizie.tech/v1/communication:sendgrid-suppressions-v3/search-suppression-from-asm-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| group_id | string | yes | The ID of the suppression group that you would like to search. |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |
| body | object | no | JSON request body |

### Retrieve all suppressions
`GET https://apizie.tech/v1/communication:sendgrid-suppressions-v3/list-asm-suppression` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Retrieve all suppression groups for an email address
`GET https://apizie.tech/v1/communication:sendgrid-suppressions-v3/get-asm-suppression` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| email | string | yes | The email address that you want to search suppression groups for. |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Retrieve all blocks
`GET https://apizie.tech/v1/communication:sendgrid-suppressions-v3/list-suppression-block` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| start_time | integer | no | The start of the time range when a blocked email was created (inclusive). This is a unix timestamp. |
| end_time | integer | no | The end of the time range when a blocked email was created (inclusive). This is a unix timestamp. |
| 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… |
| 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`… |
| email | string | no | Specifies which records to return based on the records' associated email addresses. For example, `sales` returns records with email… |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Delete blocks
`POST https://apizie.tech/v1/communication:sendgrid-suppressions-v3/delete-suppression-blocks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |
| body | object | no | JSON request body |

### Retrieve a specific block
`GET https://apizie.tech/v1/communication:sendgrid-suppressions-v3/get-suppression-block` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| email | string | yes | The email address of the specific block. |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Delete a specific block
`POST https://apizie.tech/v1/communication:sendgrid-suppressions-v3/delete-suppression-block` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| email | string | yes | The email address of the specific block. |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Retrieve all bounces
`GET https://apizie.tech/v1/communication:sendgrid-suppressions-v3/list-suppression-bounces` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| start_time | integer | no | Refers start of the time range in unix timestamp when a bounce was created (inclusive). |
| end_time | integer | no | Refers end of the time range in unix timestamp when a bounce was created (inclusive). |
| 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… |
| 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`… |
| email | string | no | Specifies which records to return based on the records' associated email addresses. For example, `sales` returns records with email… |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Delete bounces
`POST https://apizie.tech/v1/communication:sendgrid-suppressions-v3/delete-suppression-bounces` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |
| body | object | no | JSON request body |

### Retrieve a Bounce
`GET https://apizie.tech/v1/communication:sendgrid-suppressions-v3/get-suppression-bounces` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| email | string | yes | The email address of the specific bounce you would like to retrieve |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Delete a bounce
`POST https://apizie.tech/v1/communication:sendgrid-suppressions-v3/delete-suppression-bounce` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| email | string | yes | The email address you would like to remove from the bounce list. |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Retrieve bounce classification totals
`GET https://apizie.tech/v1/communication:sendgrid-suppressions-v3/list-suppression-bounces-classifications` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| start_date | string | no | The start of the time range, in YYYY-MM-DD format, when a bounce was created (inclusive). |
| end_date | string | no | The end of the time range, in YYYY-MM-DD format, when a bounce was created (inclusive). |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Retrieve bounce classification over time by domain stats
`GET https://apizie.tech/v1/communication:sendgrid-suppressions-v3/get-suppression-bounces-classifications` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| classification | string | yes | The classification you want to filter by. Possible values are: `Content`, `Frequency or Volume Too High`, `Invalid Address`, `Mailbox… |
| start_date | string | no | The start of the time range, in YYYY-MM-DD format, when a bounce was created (inclusive). |
| end_date | string | no | The end of the time range, in YYYY-MM-DD format, when a bounce was created (inclusive). |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Add recipient addresses to the global suppression group.
`POST https://apizie.tech/v1/communication:sendgrid-suppressions-v3/create-global-suppression` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |
| body | object | no | JSON request body |

### Retrieve a Global Suppression
`GET https://apizie.tech/v1/communication:sendgrid-suppressions-v3/get-global-suppression` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| email | string | yes | The email address of the global suppression you want to retrieve. Or, if you want to check if an email address is on the global… |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Delete a Global Suppression
`POST https://apizie.tech/v1/communication:sendgrid-suppressions-v3/delete-global-suppression` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| email | string | yes | The email address of the global suppression you want to retrieve. Or, if you want to check if an email address is on the global… |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Retrieve all invalid emails
`GET https://apizie.tech/v1/communication:sendgrid-suppressions-v3/list-invalid-email` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| start_time | integer | no | Refers start of the time range in unix timestamp when an invalid email was created (inclusive). |
| end_time | integer | no | Refers end of the time range in unix timestamp when an invalid email was created (inclusive). |
| 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… |
| 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`… |
| email | string | no | This parameter allows you to filter results by email address. Only invalid addresses matching an address passed in this parameter will be… |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Delete invalid emails
`POST https://apizie.tech/v1/communication:sendgrid-suppressions-v3/delete-invalid-emails` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |
| body | object | no | JSON request body |

### Retrieve a specific invalid email
`GET https://apizie.tech/v1/communication:sendgrid-suppressions-v3/get-invalid-email` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| email | string | yes | The specific email address of the invalid email entry that you want to retrieve. |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Delete a specific invalid email
`POST https://apizie.tech/v1/communication:sendgrid-suppressions-v3/delete-invalid-email` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| email | string | yes | The specific email address of the invalid email entry that you want to retrieve. |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Retrieve all spam reports
`GET https://apizie.tech/v1/communication:sendgrid-suppressions-v3/list-spam-report` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| start_time | integer | no | The start of the time range when a spam report was created (inclusive). This is a unix timestamp. |
| end_time | integer | no | The end of the time range when a spam report was created (inclusive). This is a unix timestamp. |
| 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… |
| 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`… |
| email | string | no | Specifies which records to return based on the records' associated email addresses. For example, `sales` returns records with email… |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Delete spam reports
`POST https://apizie.tech/v1/communication:sendgrid-suppressions-v3/delete-spam-reports` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |
| body | object | no | JSON request body |

### Retrieve a specific spam report
`GET https://apizie.tech/v1/communication:sendgrid-suppressions-v3/get-spam-report` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| email | string | yes | The email address of a specific spam report that you want to retrieve. |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Delete a specific spam report
`POST https://apizie.tech/v1/communication:sendgrid-suppressions-v3/delete-spam-report` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| email | string | yes | The email address of a specific spam report that you want to retrieve. |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

### Retrieve all global suppressions
`GET https://apizie.tech/v1/communication:sendgrid-suppressions-v3/list-global-suppression` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| start_time | integer | no | Refers start of the time range in unix timestamp when an unsubscribe email was created (inclusive). |
| end_time | integer | no | Refers end of the time range in unix timestamp when an unsubscribe email was created (inclusive). |
| 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… |
| 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`… |
| email | string | no | Specifies which records to return based on the records' associated email addresses. For example, `sales` returns records with email… |
| on-behalf-of | string | no | The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You… |

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

## FAQ

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

### Is the Twilio SendGrid Suppressions 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 Suppressions API itself also needs your own key from sendgrid.com.

### Can AI agents use the Twilio SendGrid Suppressions 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-suppressions-v3.

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