---
title: "Batch companies create"
method: POST
path: "/people/2/companies/batch"
tags: ["customer-engagement", "people", "company-profile"]
---

# Batch companies create

`POST /people/2/companies/batch`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/people/2/companies/batch`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`
  - API key in header `Authorization`
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`

Use this method to create multiple companies.<br>**NOTE** Array size of the batch create request is limited to `1000` companies.

## Request body

- 8f56537725b251ff8d954dfe25d40799c66fa1fccf8d6a81cf1331f5159a40d1BatchCreateRequest
  - `companies` F1f4d23441e1a2e5d9e00e8bea59bdb50b3ee0c91558c0dac55f3a711b5f2d3fIamCompanyV2[]: List of companies.
    - `accountManager` string: Account manager.
    - `country` string: Country.
    - `createdAt` string: Date and time of creation. Has the following format: yyyy-MM-dd'T'HH:mm:ss.
    - `customAttributes` object: List of custom attributes for the company.
    - `customerStage` string: Customer stage.
    - `domains` string[]: List of domains for the company.
    - `externalId` string: Unique ID for a company from your or another external system, 256 characters max
    - `id` integer: Unique id of the entity.
    - `industry` string: Industry.
    - `modifiedAt` string: Date and time of last modification. Has the following format: yyyy-MM-dd'T'HH:mm:ss.
    - `modifiedFrom` 'API' | 'PORTAL' | 'WEB_SDK' | 'INTEGRATION' | 'PUSH' | 'FACEBOOK' | 'LINE' | 'TELEGRAM' | 'SALESFORCE' | 'DYNAMICS' | 'ZAPIER' | 'FORMS' | 'COMPUTED' | 'ANSWERS' | 'CONVERSATIONS'
    - `name` string, required: Company name.
    - `notes` string: Notes.
    - `origin` 'API' | 'PORTAL' | 'WEB_SDK' | 'INTEGRATION' | 'PUSH' | 'FACEBOOK' | 'LINE' | 'TELEGRAM' | 'SALESFORCE' | 'DYNAMICS' | 'ZAPIER' | 'FORMS' | 'COMPUTED' | 'ANSWERS' | 'CONVERSATIONS'
    - `region` string: Region.
    - `segment` string: Segment.
    - `serviceData` object: Company's service information.
    - `tags` string[]: List of tags for the company.
    - `vatNumber` string: VAT number.

## Response `200`

successful response

- 8f56537725b251ff8d954dfe25d40799c66fa1fccf8d6a81cf1331f5159a40d1BatchCreateResponse
  - `results` 8f56537725b251ff8d954dfe25d40799c66fa1fccf8d6a81cf1331f5159a40d1BatchCreateResult[]: List of result from the batch operation for each processed entry. Example, the first company was created, the second company wasn't created because name already exists.
    - `errors` 3206ab1528b990358dc5d8da723b52b5db6e1d582712d39b5ed66ac5c4b1e84fBatchOperationError[]: List of errors
      - `message` string: Error message
    - `id` integer: Id of created company
    - `index` integer: Index of company in request list
    - `status` integer: HTTP status

## Other responses

- `207`: successful response
- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error
- `4XX`: Error responses
- `5XX`: Error responses

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)