# Create a business entity

> For the complete machine-readable documentation index, see [llms.txt](https://apidocs.chargebee.com/llms.txt).


[Idempotency Supported](/docs/api/idempotency)

Creates a `business_entity` resource for the site. Use this endpoint to set up an additional business unit or brand under your organization, each with its own configuration and data.

**Note** This endpoint is available only when [multiple business entities](https://www.chargebee.com/docs/2.0/mbe.html) are enabled for your site.

## Sample Request

#### Chargebee CLI

```bash
chargebee business-entity create \
    -d 'name=Acme Inc' \
    -d status=active
```

#### cURL

```bash
curl  https://{site}.chargebee.com/api/v2/business_entities \
     -u {site_api_key}:\
     -d name="Acme Inc" \
     -d status="active"
```

#### .NET

```dotnet
using ChargeBee.Api;
using ChargeBee.Models;

ApiConfig.Configure("{site}","{site_api_key}");
EntityResult result = BusinessEntity.Create()
		.Name("Acme Inc")
		.Status(BusinessEntity.StatusEnum.Active)
		.Request();

BusinessEntity businessEntity = result.BusinessEntity;
```

#### Go

```go
package main
import (
    "fmt"
    "github.com/chargebee/chargebee-go/v3"
    businessentityAction "github.com/chargebee/chargebee-go/v3/actions/businessentity"
    "github.com/chargebee/chargebee-go/v3/models/businessentity"
    businessEntityEnum "github.com/chargebee/chargebee-go/v3/models/businessentity/enum"
)
func main() {
    chargebee.Configure("{site_api_key}","{site}");
    res,err := businessentityAction.Create(&businessentity.CreateRequestParams{
        Name : "Acme Inc",
        Status : businessEntityEnum.StatusActive,
    }).Request()
    if err != nil {
        fmt.Println(err)
    } else {
        BusinessEntity := res.BusinessEntity
    }
}
```

#### Go

```go
package main

import (
  "fmt"
  "github.com/chargebee/chargebee-go/v4"
)

func main() {
  config := &chargebee.ClientConfig{
    SiteName: "{site}",
    ApiKey: "{site_api_key}",
  }    
  client := chargebee.NewClient(config)
  req := &chargebee.BusinessEntityCreateRequest{
    Name : "Acme Inc",
    Status : chargebee.BusinessEntityStatusActive,
}
  res, err := client.BusinessEntity.Create(req)
      if err != nil {
        fmt.Println(err)
    } else {
        BusinessEntity := res.BusinessEntity
    }
}
```

#### Java

```java
import com.chargebee.*;
import com.chargebee.ListResult;
import com.chargebee.models.*;
import com.chargebee.models.enums.*;
import java.io.IOException;

public class Sample {

    public static void main(String args[]) throws IOException, Exception {
        Environment.configure("{site}", "{site_api_key}");
        Result result = BusinessEntity.create()
            .name("Acme Inc")
            .status(BusinessEntity.Status.ACTIVE)
            .request();

        BusinessEntity businessEntity = result.businessEntity();
    }
}
```

#### Java

```java
import com.chargebee.v4.client.ChargebeeClient;
import com.chargebee.v4.models.businessEntity.BusinessEntity;
import com.chargebee.v4.models.businessEntity.params.BusinessEntityCreateParams;
import com.chargebee.v4.models.businessEntity.responses.BusinessEntityCreateResponse;

public class BusinessEntityCreate {

    public static void main(String[] args) {
        ChargebeeClient client = ChargebeeClient.builder()
            .apiKey("{site_api_key}")
            .siteName("{site}")
            .build();

        BusinessEntityCreateParams params = BusinessEntityCreateParams.builder()
            .name("Acme Inc")
            .status(BusinessEntityCreateParams.Status.ACTIVE)
            .build();

        BusinessEntityCreateResponse response = client.businessEntities().create(params);

        BusinessEntity businessEntity = response.getBusinessEntity();
    }
}
```

#### Node.js

```node
import Chargebee from "chargebee";

const chargebee = new Chargebee({
    site: "{site}",
    apiKey: "{site_api_key}",
});

try {
    const result = await chargebee.businessEntity.create({
        name: "Acme Inc",
        status: "active"
    });

    console.log(result);
    const businessEntity = result.business_entity;
} catch (err) {
    console.log(err);
}
```

#### PHP

```php
<?php

require __DIR__ . '/vendor/autoload.php';

use Chargebee\ChargebeeClient;

$chargebee = new ChargebeeClient(options: [
    "site" => "{site}",
    "apiKey" => "{site_api_key}",
]);
$result = $chargebee->businessEntity()->create([
    "name" => "Acme Inc",
    "status" => "active"
]);
$businessEntity = $result->business_entity;
```

#### Python

```python
import chargebee
from chargebee import Chargebee

cb_client = Chargebee(api_key="{site_api_key}", site="{site}")
response = cb_client.BusinessEntity.create(
    cb_client.BusinessEntity.CreateParams(
        name="Acme Inc",
        status=chargebee.BusinessEntity.Status.ACTIVE
    )
)
business_entity = response.business_entity
```

#### Ruby

```ruby
require 'chargebee'

ChargeBee.configure(:site => "{site}",
  :api_key => "{site_api_key}")

result = ChargeBee::BusinessEntity.create({
  :name => "Acme Inc",
  :status => "ACTIVE"
})

business_entity = result.business_entity
```

## Sample Response

```json
{
  "business_entity": {
    "id": "__test__KyVnHhSBWlF0Q2dg",
    "name": "Acme Inc",
    "object": "business_entity",
    "resource_version": 1517505747000,
    "status": "active",
    "updated_at": 1517505747,
    "created_at": 1517505747,
    "deleted": false
  }
}
```

## URL Format

**POST** https://[site].chargebee.com/api/v2/business_entities

## Input Parameters

- `name` (required, string, max chars=100)
  A human-friendly name for the business entity.

- `status` (required, enumerated string)
  The status to set for the business entity.
  Possible enum values:
    - `active`
      The business entity is active and can be used.
    - `inactive`
      The business entity is inactive and cannot be used.

## Returns

- `business_entity` (Business entity object)
  Resource object representing `business_entity` .