Skip to content

POST /gmail/v1/users/{userId}/labels ​

Create a new label

DetailValue
Operation IDcreateLabel
MethodPOST
Path/gmail/v1/users/{userId}/labels
ConnectorGmail

Parameters ​

NameLocationTypeRequired
userIdpathstringYes

Request Body ​

FieldType
namestring
messageListVisibilitystring
labelListVisibilitystring

Using this endpoint in a workflow ​

  1. Add an API Call node to your workflow.
  2. Pick your Gmail connection from the Connection dropdown.
  3. In the Operation dropdown, select createLabel.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns ​

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Gmail API reference.