PlatformDocs
MCP server

delete_list

Deletes a list for good.

View as Markdown

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

ParameterTypeRequiredAcceptsDescription
websiteIdstringYesanyWebsite ID from list_websites.
listTypestringYescontact, companycontact for lists of people, company for lists of companies.
listIdstringYesany_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