Lists

Build a company list from a contact list's companies

Builds a new company list from the companies the contact list's rows belong to. Async: 202 returns the created list (in processing state) and sourceContacts, the number of contacts examined; poll GET /business/lists/{listId} on the new id until completionStatus is complete. A source list still being built answers 409 LIST_PROCESSING — retry once its own completionStatus leaves processing.

Errors:

  • 404 LIST_NOT_FOUND — No source list with that id is visible to the token owner.
  • 409 LIST_NAME_TAKEN — A list already carries the requested name.
  • 409 LIST_PROCESSING — The source list is still being built; retry once its completionStatus leaves processing.
  • 422 CONTACT_LIST_REQUIRED — The source list is a company list; companies are derived from a contact list's rows.
  • 422 LIST_EMPTY — The source list has no contacts to derive companies from.
  • 422 INVALID_REQUEST — CRM rejected the request for a reason outside the mapped set.
  • 422 VALIDATION_FAILED — name missing/blank or over 255 characters, or an unknown body key.
  • 429 RATE_LIMITED — The lists rate bucket (120 requests/minute, 10,000/day per token owner) is exhausted.

Requires one of the following token scopes: lists.

post/business/lists/{listId}/derive-company-list

Request

  • Base URL: https://api.tryfuse.ai/api/v1
  • URL: https://api.tryfuse.ai/api/v1/business/lists/{listId}/derive-company-list
  • Auth: HTTP basic

Path parameters

listIdstring required

24-character hex id of the list (from GET /business/lists).

Request body

namestring required

Name for the new company list (1-255 characters); a name already in use answers 409 LIST_NAME_TAKEN.

Response

Success

sourceContactsinteger nullable required

Changes

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