Delete contacts

If you have questions regarding this API, please visit our API FAQ page.

Deleting contacts

Make a DELETE request to https://webapi.inboxroad.com/api/v2/contacts-lists/{blueprint_id}/contacts/ with a valid X-API-Key. Pass one or more contact ids to delete in the body.

curl -X DELETE 'https://webapi.inboxroad.com/api/v2/contacts-lists/{blueprint_id}/contacts/' \
  -H 'X-API-Key: <your_token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "list_ids": [4821, 4822]
  }'

Path parameters

Param name	Description
blueprint_id	Unique identifier of the contacts list (UUID).

Request fields

Field name	Required	Description
list_ids	Yes	Array of contact ids (integers) to delete. All must belong to the list.

Example request

{
  "list_ids": [4821, 4822]
}

Response

Returns 200 with a human-readable confirmation message.

{
  "message": "Deleted 2 contacts"
}

Possible response codes

Status code	Description
200	Contacts deleted successfully.
400	Invalid request data.
401	Unauthorized.