updateGroup

Modify group details or update members in a single operation. Rename the group, add multiple contacts, or remove several members at once using group ID and relevant contact IDs.

Instructions

Update a group or list. Use this to update the group title and/or modify its members. When adding or removing contacts, provide ALL contact IDs to add/remove in a single call - do not make multiple calls for individual contacts.

Input Schema

Name	Required	Description
`add_contact_ids`	No	A list of contact IDs that should be added to this group. Each ID should be a number representing an existing contact in your network. You can provide multiple IDs to add several contacts at once.
`group_id`	Yes	The ID of the group or list to update.
`remove_contact_ids`	No	A list of contact IDs that should be removed from this group. Each ID should be a number representing an existing contact in your network. You can provide multiple IDs to remove several contacts at once.
`title`	No	The new name of the group if the user wants to rename it.

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "add_contact_ids": {
      "default": [],
      "description": "A list of contact IDs that should be added to this group. Each ID should be a number representing an existing contact in your network. You can provide multiple IDs to add several contacts at once.",
      "items": {
        "type": "number"
      },
      "type": "array"
    },
    "group_id": {
      "description": "The ID of the group or list to update.",
      "type": "number"
    },
    "remove_contact_ids": {
      "default": [],
      "description": "A list of contact IDs that should be removed from this group. Each ID should be a number representing an existing contact in your network. You can provide multiple IDs to remove several contacts at once.",
      "items": {
        "type": "number"
      },
      "type": "array"
    },
    "title": {
      "description": "The new name of the group if the user wants to rename it.",
      "type": "string"
    }
  },
  "required": [
    "group_id"
  ],
  "type": "object"
}

Clay

updateGroup

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Clay

Related Tools

MCP directory API