PlatformDocs
MCP server

create_list

Creates an empty contact or company list on a website and returns it.

View as Markdown

Create a list · Changes data

Creates an empty contact or company list on a website and returns it. Add people to it from the dashboard or a campaign.

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.
namestringYesanyThe list's name.

Tool definition

What your assistant receives from tools/list:

{
  "name": "create_list",
  "title": "Create a list",
  "annotations": {
    "title": "Create a list",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": false,
    "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."
      },
      "name": {
        "type": "string",
        "description": "The list's name."
      }
    },
    "required": [
      "websiteId",
      "listType",
      "name"
    ]
  }
}

On this page