Contacts
DELETE
Delete Contact
DELETE /v1/contacts/{contactId}Permanently delete a contact from your workspace.
Use Cases:
- Remove contacts who requested data deletion (GDPR compliance)
- Clean up invalid or test contacts
- Remove bounced or spam complaint contacts
- Comply with data retention policies
- Delete duplicates after merging
Behavior:
- Contact is permanently deleted and cannot be recovered
- All associated data is removed (properties, subscriptions)
- Contact is removed from all topics and segments
- Historical email stats are preserved but anonymized
- Form submissions from this contact remain in analytics
- Operation is idempotent (no error if already deleted)
Required Scope: write:contacts
Data Deletion:
- Contact record and all properties deleted
- Topic subscriptions removed
- Segment memberships recalculated
- Email engagement history anonymized
- Cannot be undone - ensure this is intentional
Important:
- This is a hard delete, not an archive
- Consider unsubscribing instead if you need to retain history
- For GDPR "right to be forgotten" requests
- Automation triggers may reference deleted contacts in logs
Note: If you need to preserve historical data, consider marking contacts as unsubscribed instead of deleting them.
Path parameters
contactIdstringrequiredContact ID
Response
200Contact permanently deleted successfully. Returns the deleted contact's ID for confirmation.
objectstringrequiredidstringrequiredID of the deleted contact