Skip to main content

Remove Contact from List

Remove a contact from a list.

This affects list membership only, and is reversible: the contact can be added back to the list at any time with Add Contact to List. It is not an unsubscribe — the contact keeps receiving mail from any other lists they belong to, and from campaigns and automations targeting your whole account. To stop emailing a contact entirely, use Unsubscribe Contact instead.

Request​

DELETE /lists/{listUuid}/contacts/{contactUuid}

Path Parameters​

ParameterTypeDescription
listUuidstringList's UUID
contactUuidstringContact's UUID

This endpoint is idempotent — if the contact is not a member of the list, the request is silently ignored and a 204 No Content response is returned.

Example Request​

curl -X DELETE "https://email.easy.tools/api/v1/lists/70dbd819-fac2-4dcf-b655-fb925e24410b/contacts/d2c1b0a9-8e7f-4d6c-b5a4-3210fedcba98" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Response​

Success Response (204 No Content)​

No response body.

Error Responses​

Not Found Error (404) - List​

{
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "List with uuid '70dbd819-fac2-4dcf-b655-fb925e24410b' not found"
  }
}