Associate a Contact

Use this endpoint to link a contact to a list in Engage.

Endpoint and Methods

POST /_rest/v2/lists/:id/associate

Parameters

  • List Id

Body

Required field:

  • selectedContacts (valid array of contact ids)

Sample Request

Copy
{
“selectedContacts”: [“5e31ca72489fe77fb5ed8e5d”]
}

Sample Responses

Code 204 Response

Response code 200 returns no content if the contact(s) are successfully associated to the list.

Code 401 Response

Response code 401 returns an error that the authorization token is invalid.

Code 422 Response

Response code 422 returns a message that the contact id is invalid inside selectedContacts.

Code 500 Response

Response code 500 returns an error when an unknown internal error occurs.