Customers

Create a business

Create a business.

POST

/agency/businesses

Create a business

curl --request POST \
  --url https://api-example.kickcall.ai/api/v1/agency/businesses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "business": {
    "business_plan_id": 123,
    "email": "jsmith@example.com",
    "industry": "<string>",
    "legal_name": "<string>",
    "name": "<string>",
    "niche": "<string>",
    "phone": "<string>",
    "website": "<string>"
  }
}
'

{
  "account_status": "active",
  "address": {
    "city": "Toronto",
    "country": "CA",
    "platform_language": "en",
    "postal_code": "M5V 2T6",
    "state": "ON",
    "street_address": "100 Main St",
    "time_zone": "America/Toronto"
  },
  "agents_count": 3,
  "avatar_url": null,
  "business_plan_id": 12,
  "created_at": "2025-06-01T15:00:00.000Z",
  "email": "ops@acme.example",
  "id": 286,
  "industry": "healthcare",
  "legal_name": "Acme Dental Inc.",
  "locations_count": 2,
  "name": "Acme Dental",
  "niche": "dental",
  "phone": "+14165550100",
  "uid": "biz_acme",
  "website": "https://acme.example"
}

Audience: Agency portal. Auth: Agency JWT or agency API key (Authorization: Bearer or X-Api-Key). Resource: Businesses.

Authorizations

Authorizationstringheaderrequired

JWT from OTP login, or business/agency API key string.

Body

businessobjectrequired

Show child attributes

Response

Created — Created business

account_statusstring

business_plan_idinteger | null

created_atstring

emailstring

idinteger

namestring

phonestring | null

Still need help? Ask the team