Skip to main content
Contacts

Unblock a contact

Unblocks a contact by their Featurebase ID from the global moderation system.

POST
/v2/contacts/{id}/unblock

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.

Authorizations

Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

Path Parameters

idstringrequired

Featurebase contact ID

Example: 507f1f77bcf86cd799439011

Headers

Featurebase-Versionenum<string>header

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

Available options: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover
Example: 2026-08-19.orbit

Response

application/json

Success

idstringrequired

Unique identifier of the unblocked contact

Example: 507f1f77bcf86cd799439011
objectenum<string>required

Object type identifier

Available options: contact
Example: contact
unblockedenum<boolean>required

Indicates the contact was unblocked

Available options: true
Example: true

Still need help? Ask the team