Add or remove members from a business unit Run in API Explorer

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://apidocs.plannrcrm.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "PlannrCRM MCP server": {
    "url": "https://apidocs.plannrcrm.com/mcp"
  }
}
Close
POST /api/v1/business-units/{business_unit_uuid}/members/{action}
Personal access token & O auth2

Bulk add or remove account members from a business unit. When adding, accounts already assigned to a different business unit are reassigned to this one.

Headers

  • X-PLANNR-ACCOUNT-UUID string

Path parameters

  • business_unit_uuid string Required
  • action string Required

    The action to perform. Allowed: add, remove.

  • business_unit string Required

    The UUID of the business unit.

application/json

Body

  • accounts array[string(uuid)] Required

    UUIDs of accounts to add to or remove from the business unit.

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • successful array[string]
    • failed array
  • 422 application/json

    Validation error

    Hide response attributes Show response attributes object
    • message string Required

      A human-readable description of the error.

    • errors object

      Validation messages keyed by the field that failed.

      Hide errors attribute Show errors attribute object
      • * array[string] Additional properties
POST /api/v1/business-units/{business_unit_uuid}/members/{action} 
curl \
 --request POST 'https://api.plannrcrm.com/api/v1/business-units/6ff8f7f6-1eb3-3525-be4a-3932c805afed/members/add' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 --data '{
  "accounts": [
    "fa033951-7c8e-468f-a880-a32dd4531666",
    "48068d83-f999-4fd9-afe6-8922b8e27bce",
    "ef6ec5ab-d807-4138-aa01-50917020ddc0"
  ]
}'
Request examples 
# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "accounts": [
    "fa033951-7c8e-468f-a880-a32dd4531666",
    "48068d83-f999-4fd9-afe6-8922b8e27bce",
    "ef6ec5ab-d807-4138-aa01-50917020ddc0"
  ]
}
Response examples (200) 
{
  "successful": [
    "uuid-1",
    "uuid-2"
  ],
  "failed": []
}
Response examples (422) 
{
  "message": "The given data was invalid.",
  "errors": {
    "field": [
      "The field is invalid."
    ]
  }
}