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
Response
Success
Changes
No recorded changes to this operation across all 1 revision of this API.