v1
latestOpenAPI 3.1.02026-07-26359254.7 MBContact Lists
Add contacts to a contact list
<small>Requires the contacts:operate scope (or a broader one that includes it).</small>
Adds contacts to the specified contact list. This is a non-atomic operation: successfully added contacts are not rolled back if some fail. The response contains only the failed items with their error details.
post/v3/contact-lists/{id}/add-contacts
Path parameters
idinteger required
Contact list ID
Request body
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:
| error | Meaning |
|---|---|
| 8 | ContactNotProcessed — contact could not be added (e.g. access denied, invalid ID) |
object required