Delete contacts
DELETE/api/partner-gateway/v1/contacts
Deletes contacts from your account. This endpoint supports two mutually exclusive modes. Mode 1 (selective delete): Provide ids as a comma-separated list of contact IDs to delete specific contacts. When ids is present, the notIds parameter is ignored. Mode 2 (bulk delete with exclusions): Provide notIds as a comma-separated list of contact IDs to keep, and all other contacts in your account will be deleted. This operation permanently removes the contact records and also removes their associations with any contact lists. Deleted contacts will no longer be available as recipients for future campaigns. Delivery history for past campaigns that included these contacts is preserved. Use this with caution, especially Mode 2, as it can delete a large number of contacts in a single call. Returns 200 with the result of the deletion operation. Returns 500 if an unexpected server error occurs.
Request
Responses
- 200
- 500
Contacts deleted successfully
Internal server error