Action: Remove Label From Conversation

Gmail Operation

The Remove Label From Conversation action deletes a specified label from a selected email thread in Gmail.

Example User Story

I want to remove the 'Urgent' label from a resolved conversation so it no longer clutters my priority view.

Fields

Field Name	Field Type	Required
conversationId	String	Yes
labelId	String	Yes
userId	String	No

Related Connections

Gmail

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "remove-label-from-conversation",
  "state": "inDev",
  "meta": {
    "short": "Remove Label From Conversation",
    "description": "Removes a specified label from a conversation in Gmail."
  },
  "input": [
    {
      "name": "conversationId",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The ID of the conversation to remove the label from."
      }
    },
    {
      "name": "labelId",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The ID of the label to remove from the conversation."
      }
    },
    {
      "name": "userId",
      "type": "String",
      "required": false,
      "meta": {
        "description": "The user's email address or 'me' to indicate the authenticated user. Defaults to 'me'."
      }
    }
  ],
  "output": [
    {
      "name": "success",
      "type": "Boolean",
      "selector": [],
      "meta": {
        "description": "Indicates whether the label was successfully removed."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "POST",
        "path": "/gmail/v1/users/{{userId}}/messages/{{conversationId}}/modify",
        "headers": {
          "Content-Type": "application/json"
        },
        "bodyTemplate": {
          "value": "{\"removeLabelIds\": [\"{{labelId}}\"]}",
          "placeholders": [
            {
              "name": "labelId",
              "type": "String",
              "description": "The ID of the label to remove.",
              "required": true
            }
          ]
        }
      }
    }
  ]
}