Create Filters

POST {{baseUrl}}/gmail/v1/users/:userId/settings/filters

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

Request Params

KeyDatatypeRequiredDescription
access_tokenstringOAuth access token.
altstringData format for response.
callbackstringJSONP
fieldsstringSelector specifying which fields to include in a partial response.
keystringAPI key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
oauth_tokenstringOAuth 2.0 token for the current user.
prettyPrintstringReturns response with indentations and line breaks.
quotaUserstringAvailable to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
upload_protocolstringUpload protocol for media (e.g. "raw", "multipart").
uploadTypestringLegacy upload protocol for media (e.g. "media", "multipart").
$.xgafvstringV1 error format.

Request Body

{"id"=>"in aute anim", "criteria"=>{"from"=>"nulla adipisicing veniam et mollit", "to"=>"veniam commodo", "subject"=>"sit exercitation", "query"=>"nulla cupidatat officia commodo laborum", "negatedQuery"=>"exercitation laboris", "hasAttachment"=>true, "excludeChats"=>false, "size"=>-52983385, "sizeComparison"=>"smaller"}, "action"=>{"addLabelIds"=>["nostrud laboris sed esse", "et ad"], "removeLabelIds"=>["Lorem consequat l", "minim Excepteur"], "forward"=>"culpa do"}}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{"id":"in aute anim","criteria":{"from":"nulla adipisicing veniam et mollit","to":"veniam commodo","subject":"sit exercitation","query":"nulla cupidatat officia commodo laborum","negatedQuery":"exercitation laboris","hasAttachment":true,"excludeChats":false,"size":-52983385,"sizeComparison":"smaller"},"action":{"addLabelIds":["nostrud laboris sed esse","et ad"],"removeLabelIds":["Lorem consequat l","minim Excepteur"],"forward":"culpa do"}}