> For the complete documentation index, see [llms.txt](https://docs.cuoral.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cuoral.com/api-reference/customers/company/bulk-create-companies.md).

# Bulk Create Companies

POST /external/v1/external/v1/customers/companies/bulk 

Parameters

* None

Request Body (application/json)

The request body is a JSON object containing an array of company objects.

| **Field** | **Type**         | **Description**                                 | **Required** |
| --------- | ---------------- | ----------------------------------------------- | ------------ |
| companies | Array of Objects | An array of up to 50 company objects to create. | Yes          |

Company Object Fields:

| **Field**       | **Type** | **Description**                            |
| --------------- | -------- | ------------------------------------------ |
| company\_name   | `string` | The official name of the company.          |
| company\_email  | `string` | A primary email address for the company.   |
| company\_status | `string` | The operational status (e.g., `'active'`). |
| description     | `string` | A brief description.                       |
| industry        | `string` | The company's industry.                    |
| website         | `string` | The company's main website URL.            |
| phone           | `string` | The company's primary phone number.        |
| address         | `string` | The company's physical street address.     |

Example Request Body:

```json
{
  "companies": [
    {
      "company_name": "Acme Corp",
      "company_email": "info@acme.com",
      "company_status": "active",
      "description": "Manufacturing",
      "industry": "Manufacturing",
      "website": "https://www.acme.com",
      "phone": "555-1212",
      "address": "1 Main St"
    }
  ]
}
```

Successful Response (201) (application/json)

| **Field** | **Type**         | **Description**                              |
| --------- | ---------------- | -------------------------------------------- |
| created   | `integer`        | The count of companies successfully created. |
| companies | Array of Objects | The list of newly created company objects.   |

Created Company Object Fields (Includes all request fields plus):

| **Field**        | **Type**            | **Description**           |
| ---------------- | ------------------- | ------------------------- |
| id               | `integer`           | The internal database ID. |
| company\_id      | `string`            | The unique external ID.   |
| time\_created    | `string` (datetime) | Creation timestamp.       |
| time\_updated    | `string` (datetime) | Last update timestamp.    |
| organization\_id | `integer`           | The organization ID.      |

Example Response Body (201):

JSON

```json
{
  "created": 1,
  "companies": [
    {
      "company_name": "string",
      "company_email": "user@example.com",
      "company_status": "active",
      "description": "string",
      "industry": "string",
      "website": "string",
      "phone": "string",
      "address": "string",
      "id": 0,
      "company_id": "string",
      "time_created": "2025-11-27T09:49:41.568Z",
      "time_updated": "2025-11-27T09:49:41.568Z",
      "organization_id": 0
    }
  ]
}
```

Validation Error (422) (application/json)

```json
{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```