/gmail/v1/users/{userId}/settings/filters

POST

Creates a filter. Note: you can only create a maximum of 1,000 filters.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://gmail.googleapis.com//gmail/v1/users//settings/filters' \
--header 'Content-Type: application/json' \
--data-raw '{
    "action": {
        "addLabelIds": [
            "string"
        ],
        "forward": "string",
        "removeLabelIds": [
            "string"
        ]
    },
    "criteria": {
        "excludeChats": true,
        "from": "string",
        "hasAttachment": true,
        "negatedQuery": "string",
        "query": "string",
        "size": 0,
        "sizeComparison": "unspecified",
        "subject": "string",
        "to": "string"
    },
    "id": "string"
}'

Response Example

{
    "action": {
        "addLabelIds": [
            "string"
        ],
        "forward": "string",
        "removeLabelIds": [
            "string"
        ]
    },
    "criteria": {
        "excludeChats": true,
        "from": "string",
        "hasAttachment": true,
        "negatedQuery": "string",
        "query": "string",
        "size": 0,
        "sizeComparison": "unspecified",
        "subject": "string",
        "to": "string"
    },
    "id": "string"
}

Request

Path Params

Body Params application/json

Examples

Responses

🟢200Successful response

application/json

Body

Modified at 2023-08-15 05:40:23

/gmail/v1/users/{userId}/settings/filters

/gmail/v1/users/{userId}/settings/filters/{id}