Create Business Unit

Endpoint URL

https://{{base_url}}/api/v2/business-unit

Authentication and rate limits

Item	Details
Authentication method	OAuth 2.0 Bearer token
Rate limit	Rate Limit

Requests Example

curl --request POST \
  --url "https://{{base_url}}/api/v2/business-unit" \
  --header "Authorization: Bearer $BEARER_TOKEN" \
  --header "Content-Type: application/json" \
  --data-raw "$JSON"

Request Syntax

{
  "company": integer,
  "name": "string",
  "contact_name": "string",
  "contact_email": "string",
  "contact_phone_number": "string",
  "description": "string"
}

Body Parameters

company (integer) --
[REQUIRED]
The ID of the specific company your API is calling. For accounts with only one company, the default value is 1.
To lookup a specific company ID, see the List Company API.
name (string) --
[REQUIRED]
The name of the business unit.
Max characters = 50
The name of the business unit must be unique per account.
contact_name (string) --
The contact name of the business unit.
Max characters = 50
contact_email (string) --
The contact email of the business unit.
Max characters = 254
contact_phone_number (string) --
The contact phone number of the business unit.
Max characters = 20
description (string) --
The description of the business unit.
Max characters = 1000