v1

latestOpenAPI 3.1.02026-07-26359254.7 MB
Account Lists

Add accounts to an account list

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

Adds accounts to the specified account list, preserving any other list memberships. This is a non-atomic operation: successfully added 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}/add-accounts

Path parameters

idinteger required

Account list ID

Request body

accountIdsinteger[] required

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

Response

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

Possible per-item error codes:

errorMeaning
7AccountNotProcessed — account could not be added (e.g. wrong team, deleted, invalid ID)
object required
All 359 operations