Docs

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

contactIdstringrequired

Contact ID

Response

200Contact permanently deleted successfully. Returns the deleted contact's ID for confirmation.
objectstringrequired
idstringrequired

ID of the deleted contact

Copyright © 2026 Kibamail.·Privacy Policy