Delete a contact

Deletes a contact from your CRM. This is a soft delete: the contact stops appearing in GET /public/v1/contacts by default (pass the deleted filter as include or only to still see it) and this endpoint returns 404 for it, but the record is retained — GET /public/v1/contacts/{id} keeps resolving it with a non-null deleted_at, and anything that already references the contact (an order's sales-rep assignment, a shipping manifest that names it as driver or contact) keeps its reference and continues to render it. The delete cannot be undone through the API; recreating the contact via upsert produces a new contact with a new id. Responds 204 with no body on success, or 404 if no non-deleted contact with that id exists in your company (including one that was already deleted or belongs to another company).

A contact can be deleted at any time — no reference blocks it, regardless of the orders, shipping manifests, or company relationships that use it. No inventory is created, consumed, or released, and nothing is synced to Metrc or BioTrack. A successful delete records a delete entry in the contact's activity log and notifies the relevant users.

Required permission: contacts_permissions_delete, plus access to the contact under your team restrictions — a contact the authenticated user cannot access returns 403.