Delete contact list

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

Deleting a contact list

Make a DELETE request to https://webapi.inboxroad.com/api/v2/contacts-lists/{blueprint_id}/ with a valid X-API-Key.

curl -X DELETE 'https://webapi.inboxroad.com/api/v2/contacts-lists/{blueprint_id}/' \
  -H 'X-API-Key: <your_token>'

Path parameters

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

Response

On success the API returns 204 No Content with an empty body.

Note

If the list is referenced by any non-draft campaigns it is soft-deleted (hidden but preserved); otherwise it is removed completely along with its underlying contacts table.

Possible response codes

Status code	Description
204	Contact list deleted successfully (empty body).
400	The list cannot be deleted in its current state.
401	Unauthorized.
404	Contact list not found.
422	blueprint_id is not a valid UUID.
429	Rate limit exceeded. See Rate limiting.