Add contacts to a contact list
contacts:operate scope (or a broader one that includes it).
Use this endpoint when you need to add contacts to this list while leaving the other lists they already belong to in place. To make this list their only list, use the move-contacts endpoint instead. Contacts are processed one by one and successful additions 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 add
Response
Add operation completed. Response is a dictionary keyed by contact ID. Only failed items appear; missing IDs were added 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.