Records
Delete a CRM Record
Permanently deletes a CRM record and all associated data (notes, activity logs).
This action is irreversible.
Required scope: crm:write
DELETE
Delete a CRM record
Permanently deletes a CRM record and all data associated with it.Documentation Index
Fetch the complete documentation index at: https://developer.zeeg.me/llms.txt
Use this file to discover all available pages before exploring further.
Path parameters
| Parameter | Type | Description |
|---|---|---|
objectSlug | string | The slug of the custom CRM object the record belongs to. |
recordId | string (UUID) | The UUID of the record to delete. |
What gets deleted
Deleting a record removes:- The record itself and all its attribute values.
- Any notes attached to the record.
- Activity log entries for the record.
- The record’s presence in relation attributes on other records (it is removed from any related record’s relation list).
Response
A successful delete returns200 OK with a confirmation message:
GET requests for the same recordId return 404 Not Found.
Idempotency
Delete is not idempotent — calling it a second time on an already-deleted record returns404, not 200. If your workflow requires idempotent deletes, catch 404 and treat it as a success.
When to use this endpoint
- Hard delete — a user explicitly removes a record from the CRM.
- Cleanup — delete test records, duplicates, or outdated entries.
- GDPR / data erasure — permanently erase a contact’s record in response to a deletion request.
There is no soft-delete or archive on custom object records. If you need to mark a record as inactive without losing data, add a
status attribute to the object schema and set it to archived or inactive via PATCH instead of deleting.Last modified on May 7, 2026