Delete contact by ID

client.users.contacts.delete(, ?, ?): DeletedContact { id, deleted, object }

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.

ParametersExpand Collapse

id: string

Featurebase contact ID

params: ContactDeleteParams { featurebaseVersion }

featurebaseVersion?: "2026-01-01.nova" | "2025-12-12.clover"

API version for this request. Defaults to your organization’s configured API version if not specified.

One of the following:

"2026-01-01.nova"

"2025-12-12.clover"

ReturnsExpand Collapse

DeletedContact { 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

import Featurebase from 'featurebase-node';

const client = new Featurebase({
  apiKey: process.env['FEATUREBASE_API_KEY'], // This is the default and can be omitted
});

const deletedContact = await client.users.contacts.delete('507f1f77bcf86cd799439011');

console.log(deletedContact.id);

{
  "id": "507f1f77bcf86cd799439011",
  "deleted": true,
  "object": "contact"
}

Returns Examples

{
  "id": "507f1f77bcf86cd799439011",
  "deleted": true,
  "object": "contact"
}