# Delete contact by 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

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


### Version Availability

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

Endpoint: DELETE /v2/contacts/{id}
Version: 2026-01-01.nova
Security: bearerAuth

## Header parameters:

  - `Featurebase-Version` (string)
    API version for this request. Defaults to your organization's configured API version if not specified.
    Example: "2026-01-01.nova"

## Path parameters:

  - `id` (string, required)
    Featurebase contact ID
    Example: "507f1f77bcf86cd799439011"

## Response 200 fields (application/json):

  - `id` (string, required)
    Unique identifier of the deleted contact
    Example: "507f1f77bcf86cd799439011"

  - `object` (string, required)
    Object type identifier
    Enum: "contact"

  - `deleted` (boolean, required)
    Indicates the resource was deleted
    Enum: true

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "invalid_id"

  - `error.message` (string, required)
    Human-readable error message
    Example: "An error occurred"

  - `error.param` (string)
    The parameter that caused the error (if applicable)
    Example: "id"

  - `error.status` (number, required)
    HTTP status code
    Enum: 400

## Response 404 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "contact_not_found"

  - `error.message` (string, required)
    Human-readable error message
    Example: "An error occurred"

  - `error.param` (string)
    The parameter that caused the error (if applicable)
    Example: "id"

  - `error.status` (number, required)
    HTTP status code
    Enum: 404