Skip to content
Featurebase Featurebase Featurebase
Dashboard
API Reference
Users
Contacts

Delete contact by ID

DELETE/v2/contacts/{id}

Permanently deletes a contact by their Featurebase ID.

Supports deleting both customers and leads.

Path Parameters

  • id - The Featurebase contact ID (24-character ObjectId)

Deletion Behavior

When a contact is deleted:

  • The contact record is permanently removed
  • Associated data cleanup is triggered asynchronously
  • Comments and posts created by the contact are handled according to retention policies

Response

Returns a deletion confirmation object:

  • id - The ID of the deleted contact
  • object - Always “contact”
  • deleted - Always true

Example Response

{
  "id": "676f0f6765bdaa7d7d760f88",
  "object": "contact",
  "deleted": true
}

Version Availability

This endpoint is only available in API version 2026-01-01.nova and newer.

Path ParametersExpand Collapse
id: string

Featurebase contact ID

Header ParametersExpand Collapse
"Featurebase-Version": optional "2026-01-01.nova" or "2025-12-12.clover"
One of the following:
"2026-01-01.nova"
"2025-12-12.clover"
ReturnsExpand Collapse
DeletedContact object { id, deleted, object }
id: string

Unique identifier of the deleted contact

deleted: true

Indicates the resource was deleted

object: "contact"

Object type identifier

Delete contact by ID

curl https://do.featurebase.app/v2/contacts/$ID \
    -X DELETE \
    -H "Authorization: Bearer $FEATUREBASE_API_KEY"
{
  "id": "507f1f77bcf86cd799439011",
  "deleted": true,
  "object": "contact"
}
Returns Examples
{
  "id": "507f1f77bcf86cd799439011",
  "deleted": true,
  "object": "contact"
}