Contact Properties
DELETE
Delete Contact Property
DELETE /v1/contact-properties/{contactPropertyId}Delete a custom contact property from your workspace.
Use Cases:
- Remove unused or deprecated properties
- Clean up properties after data migration
- Simplify contact schema
- Remove test or temporary properties
- Comply with data minimization policies
Behavior:
- Property definition is permanently deleted
- Property values are removed from ALL contacts
- Segments using this property may break
- Automations referencing this property need updates
- Cannot be undone - data is permanently removed
- Cannot delete if property is required by active segments
Required Scope: write:contacts
Data Impact:
- Property definition is deleted
- All contact values for this property are removed
- Segment conditions referencing this property become invalid
- Automation triggers using this property may fail
- Form fields using this property need updates
- Historical data is lost (cannot be recovered)
Important:
- Verify no active segments or automations use this property
- Export contact data if you need to preserve values
- Consider marking as deprecated before deletion
- Update forms and integrations that reference this property
- Cannot delete default properties (email, firstName, lastName)
Blocked Deletion:
- Cannot delete if used in active segment conditions
- Cannot delete if required by running automations
- Cannot delete default system properties
Note: This is a destructive operation. All contact data for this property will be permanently lost.
Path parameters
contactPropertyIdstringrequiredContact Property ID
Response
200Contact property deleted successfully. Returns the deleted property's ID for confirmation. All contact data for this property is permanently removed.
objectstringrequiredidstringrequiredID of the deleted contact property