Skip to content
Featurebase Featurebase Featurebase
Dashboard
API Reference
Users
Contacts

Unblock a contact

POST/v2/contacts/{id}/unblock

Unblocks 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 unblocks both:

  • Customers - Users with registered accounts
  • Leads - Anonymous or unregistered visitors

Unblocking Behavior

When a contact is unblocked:

  • The contact can resume sending messages via messenger
  • Previously blocked conversations remain intact
  • The contact regains full messenger functionality

Response

Returns an unblock confirmation object:

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

Example Response

{
  "id": "507f1f77bcf86cd799439011",
  "object": "contact",
  "unblocked": 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
id: string

Unique identifier of the unblocked contact

object: "contact"

Object type identifier

unblocked: true

Indicates the contact was unblocked

Unblock a contact

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