Add Contacts to Static List
Adds contacts to a List. Maximum 500 contacts in each request. This operation is idempotent: a contact that is already on the List does not change, and you can safely retry failed contacts.
Contacts that do not exist or that the user cannot access are counted in invalid. The other contacts are still processed. URIs are listed only for contacts that were not added.
A View returns 409, because the saved filters of a View decide its contacts.
Required scopes
contacts:write
Authentication
AuthorizationBearer
OAuth 2.0
OR
AuthorizationBearer
Personal Access Token
Path parameters
uuid
The UUID of the contact list, from the end of its uri.
Request
This endpoint expects an object.
contacts
Contact URIs. Minimum 1, maximum 500. A contact that appears more than once is processed once.
Response
OK
resource
The result of adding contacts to a List. This is a result payload, not an addressable resource. URIs are listed only for contacts that were not added.
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error