Lists

Copy rows from one list into another

Copies up to limit rows from sourceListId (a contact list) into a contact list named by listId or listName (create-or-reuse by exact, case-insensitive name; a name shared by two lists is 409 LIST_NAME_AMBIGUOUS, a reserved system title is 422 LIST_NAME_RESERVED). A listId destination that is not the token owner's answers 404 LIST_NOT_FOUND before anything is dispatched. filters narrows the copied rows in the same row-filter language as GET /business/lists/{listId}/rows. Async: 202 means the copy started and listIds[0] is the destination; poll GET /business/lists/{listId} until its completionStatus is complete. The source list is not validated up front — a bad source surfaces as a job that never fills the destination.

Errors:

  • 404 LIST_NOT_FOUND — The destination listId is not a list visible to the token owner.
  • 409 LIST_NAME_TAKEN — Creating the destination by listName collided with an existing name.
  • 409 LIST_NAME_AMBIGUOUS — More than one list carries listName — reference the destination by id.
  • 422 LIST_NAME_RESERVED — listName is a system/dynamic list title and cannot be a destination.
  • 422 VALIDATION_FAILED — Missing sourceListId/limit, both or neither of listId/listName, or limit outside 1-10000.
  • 429 RATE_LIMITED — The lists rate bucket is exhausted.

Requires one of the following token scopes: lists.

post/business/lists/save-to-list

Request

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

Request body

sourceListIdstring required

24-character hex id of the contact list whose rows are copied.

limitinteger required

Maximum number of rows to copy (1-10000).

listIdstring

24-character hex id of an existing contact list to copy into; mutually exclusive with listName.

listNamestring

Name of the destination contact list (1-255 characters): an existing list with this exact name (case-insensitive) is reused, otherwise it is created; two lists sharing the name answer 409 LIST_NAME_AMBIGUOUS and reserved system titles answer 422 LIST_NAME_RESERVED.

Response

Success

listIdsstring[] required

Changes

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