v1

latestOpenAPI 3.1.02026-07-26359254.7 MB

Account Lists

Move accounts to an account list

<small>Requires the contacts:operate scope (or a broader one that includes it).</small>

Moves accounts to the specified account list, removing them from any other lists they belong to. This is a non-atomic operation: successfully moved accounts are not rolled back if some fail. The response contains only the failed items with their error details.

post/v3/contact-account-lists/{id}/move-accounts

Path parameters

idinteger required

Account list ID

Request body

accountIdsinteger[] required

Account IDs to add or move (1 to 1000 items)

Response

Move operation completed. Response is a dictionary keyed by account ID. Only failed items appear; missing IDs were moved successfully.

Possible per-item error codes:

error	Meaning
7	AccountNotProcessed — account could not be moved (e.g. wrong team, deleted, invalid ID)

object required