/bff/contact/set-parent

Assigns a parent (superior) contact. Pass null/omit parentCustomerId to detach. Rejected when the target would create a cycle or when contact equals parent.

ContactpostBffContactSet-parent

Parameters

JSON body

Request body

application/json

customerIdstringRequired

Contact external ID whose superior is being changed.

parentCustomerIdstring | nullOptional

One of 2:

Variant 1

string

External ID of the new superior. Pass null or omit to detach (contact becomes a root node).

Variant 2

null

Response schema

1 status code documented

200Success

successbooleanRequired

Default: true

Response example

application/json

{
  "success": true
}

Request example

POST /bff/contact/set-parent

post

curl -X POST "https://api.bizkithub.com/bff/contact/set-parent" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "customerId": "example_customerId"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key