HappierleadsDocs
MCP server

delete_list

Deletes a list for good.

Delete a list · Deletes or overwrites data

Deletes a list for good. The contacts or companies in it stay in the account. Confirm with the user before calling. Returns 404 when the list is not one of this website's.

ConnectionAccount URL, team member URL or OAuth

Parameters

ParameterTypeRequiredDescription
websiteIdstringYesWebsite ID from list_websites.
listType"contact" | "company"Yescontact for lists of people, company for lists of companies.
listIdstringYes_id from list_lists.

Tool definition

What your assistant receives from tools/list:

{
  "name": "delete_list",
  "title": "Delete a list",
  "annotations": {
    "title": "Delete a list",
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "websiteId": {
        "type": "string",
        "description": "Website ID from list_websites."
      },
      "listType": {
        "type": "string",
        "enum": [
          "contact",
          "company"
        ],
        "description": "contact for lists of people, company for lists of companies."
      },
      "listId": {
        "type": "string",
        "description": "_id from list_lists."
      }
    },
    "required": [
      "websiteId",
      "listType",
      "listId"
    ]
  }
}

On this page