Lists

Create a prospect list

Creates an empty list owned by the token holder. name must be unique in the workspace (409 LIST_NAME_TAKEN otherwise); entityType picks a contact list (default) or a company list. The new list starts at the folder root — move it with PATCH /business/lists/{listId}. Fill it with POST .../members (existing contacts), POST .../contacts (new raw rows), POST /business/lists/save-to-list, a search save-to-list, or an import.

Errors:

  • 409 LIST_NAME_TAKEN — A list with this name already exists in the workspace.
  • 422 VALIDATION_FAILED — The body failed validation (missing/blank name, unknown key, entityType outside contactList|companyList).
  • 429 RATE_LIMITED — The lists rate bucket is exhausted.

Requires one of the following token scopes: lists.

post/business/lists

Request

  • Base URL: https://api.tryfuse.ai/api/v1
  • URL: https://api.tryfuse.ai/api/v1/business/lists
  • Auth: HTTP basic

Request body

namestring required

List name (1-255 characters, trimmed); must be unique in the workspace or the call answers 409 LIST_NAME_TAKEN.

entityType'contactList' | 'companyList'

Kind of list to create: contactList (people, default) or companyList (companies).

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.