---
title: "Batch Update Companies"
method: POST
path: "/api/v3/crm/{integration_id}/companies/batch/update"
tags: ["CRM Companies"]
---

# Batch Update Companies

`POST /api/v3/crm/{integration_id}/companies/batch/update`

## Request

- Base URL: `https://api.nationgraph.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nationgraph.com/api/v3/crm/{integration_id}/companies/batch/update`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nationgraph/apis/nationgraph-api/docs/api/v3/crm/:integration_id/companies/batch/update/post.ts> (a function with typed inputs; its response is checked against the schema)

Update multiple companies in a single request.

## Path parameters

- `integration_id` string, uuid, required: The CRM integration ID

## Request body

- AppRoutesV3CrmCompaniesBatchUpdateRequest: Request for batch updating companies.
  - `companies` AppRoutesV3CrmCompaniesBatchUpdateItem[], required: List of companies to update
    - `id` string, required: Company ID to update
    - `properties` UpdateCompanyRequest, required: Request to update a company in HubSpot.
      - `name` string, nullable
      - `domain` string, nullable
      - `description` string, nullable
      - `phone` string, nullable
      - `address` string, nullable
      - `city` string, nullable
      - `state` string, nullable
      - `zip` string, nullable
      - `country` string, nullable
      - `website` string, nullable
      - `industry` string, nullable
      - `numberofemployees` string, nullable
      - `annualrevenue` string, nullable
      - `lifecyclestage` string, nullable
      - `hubspot_owner_id` string, nullable

## Response `200`

Successful Response

- CompanyListResponse: API response for listing companies.
  - `results` CompanyResponse[], required
    - `id` string, required
    - `properties` object, required
    - `created_at` string, nullable
    - `updated_at` string, nullable
  - `has_more` boolean
  - `next_cursor` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/nationgraph/apis/nationgraph-api.md) - [All operations](https://skmtc.dev/nationgraph/apis/nationgraph-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nationgraph/apis/nationgraph-api/revisions/85804e68d86d?raw)