# Block a contact

Blocks a contact by their Featurebase ID from the messenger/inbox.

### Path Parameters

- id - The Featurebase internal ID of the contact (MongoDB ObjectId)

### Supported Contact Types

This endpoint blocks both:
- Customers - Users with registered accounts
- Leads - Anonymous or unregistered visitors

### Blocking Behavior

When a contact is blocked:
- The contact cannot send new messages via messenger
- Existing conversations are not deleted but no new messages can be added by the blocked user
- The block can be removed by unblocking the contact

### Response

Returns a block confirmation object:
- id - The ID of the blocked contact
- object - Always "contact"
- blocked - Always true

### Example Response

json
{
  "id": "507f1f77bcf86cd799439011",
  "object": "contact",
  "blocked": true
}


### Version Availability

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

Endpoint: POST /v2/contacts/{id}/block
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 blocked contact
    Example: "507f1f77bcf86cd799439011"

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

  - `blocked` (boolean, required)
    Indicates the contact was blocked
    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