Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

Filter Commands


(warning)

This documentation is for the SendGrid Web API v2

To access all the latest features and upcoming developments, please see our v3 API.

(information)

Info

These API requests apply account-wide, unlike the SMTP API which will change the status at the individual email message level.


Get Available

get-available page anchor

List all the available apps.

Note: The name entry is used in all the other API calls to identify an app. For a list of all the apps and parameters accessible with the Web API you can check the Filter Settings page.

JSONXML

Call

GEThttps://api.sendgrid.com/api/filter.getavailable.json
GET Dataapi_user=apikey&api_key=your_sendgrid_api_key

Response


_14
[
_14
{
_14
"...": "..."
_14
},
_14
{
_14
"name": "bcc",
_14
"title": "BCC",
_14
"description": "Automatically BCC an address for every email sent from this account.",
_14
"activated": false
_14
},
_14
{
_14
"...": "..."
_14
}
_14
]



Activate an app for the entire Account.

URI ParameterRequiredRequirementsDescription
nametrueThe name of the app to activate.
JSONXML
POSThttps://api.sendgrid.com/api/filter.activate.json
POST Dataapi_user=apikey&api_key=your_sendgrid_api_key&name=bcc

_10
{
_10
"message": "success"
_10
}



Deactivate an app for the entire Account.

URI ParameterRequiredRequirementsDescription
nametrueThe name of the app to deactivate.
JSONXML
POSThttps://api.sendgrid.com/api/filter.deactivate.json
POST Dataapi_user=apikey&api_key=your_sendgrid_api_key&name=bcc

_10
{
_10
"message": "success"
_10
}



Change application settings across the entire Account. Applications and their settings can be found in the Filter Settings documentation.

JSONXML
POSThttps://api.sendgrid.com/api/filter.setup.json
POST Dataapi_user=apikey&api_key=your_sendgrid_api_key&name=bcc&email=example@example.com

_10
{
_10
"message": "success"
_10
}



Get the Settings Of An App

URI ParameterRequiredRequirementsDescription
nametrueThe name of the app for which to retrieve settings.
JSONXML
GEThttps://api.sendgrid.com/api/filter.getsettings.json
GET Dataapi_user=apikey&api_key=your_sendgrid_api_key&name=bcc

_10
{
_10
"settings": [
_10
{
_10
"email": "example@example.com"
_10
}
_10
]
_10
}


Rate this page: