Move contacts to a contact list
contacts:operate scope (or a broader one that includes it).
Use this endpoint when you need the supplied contacts to end up in this list and in no other — each contact is removed from every list it currently belongs to and placed in this one. To keep their existing memberships, use the add-contacts endpoint instead. Contacts are processed one by one and successful moves are kept even when others fail; the response returns only the contact ids that were not processed, each with its error details.
Authorizations
Authenticate every request with a Bearer token. Pass your Reply API key in the
Authorization header:
Get your API key from the Reply dashboard: Settings → API Key.
Path Parameters
Contact list ID
Body
Array of contact IDs to move
Response
Move operation completed. Response is a dictionary keyed by contact ID. Only failed items appear; missing IDs were moved successfully.
Possible per-item error codes:
Per-item error for non-atomic bulk operations. Only failed items are returned in the response dictionary. Items not present in the dictionary succeeded.