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

# Batch companies update

`PATCH /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 update multiple companies.<br>**NOTE** Array size of the batch update request is limited to `1000` companies.

## Request body

- object
  - `companies` object[]: List of companies.
    - `query` F844b0afac35672d98ce1343ef10d571c4af0fe8a10110acace5c340f3fe0877CompanyIdentityQuery
      - `id` string: Company ID
      - `externalId` string: Company external ID
      - `name` string: Company name
      - `domain` string: Company domain
    - `update` F1f4d23441e1a2e5d9e00e8bea59bdb50b3ee0c91558c0dac55f3a711b5f2d3fIamCompanyV2
      - `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

- Ff83b7738574b83363504f874ac9acc399c4aa8206175a6d6d0b7864a951905aBatchUpdateResponse
  - `results` Ff83b7738574b83363504f874ac9acc399c4aa8206175a6d6d0b7864a951905aBatchUpdateResult[]: List of any unsuccessful result from the batch operation for each processed entry. Example, name used in the request already exists.
    - `errors` 3206ab1528b990358dc5d8da723b52b5db6e1d582712d39b5ed66ac5c4b1e84fBatchOperationError[]: List of errors
      - `message` string: Error message
    - `query` object: Query used for company identification
    - `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)