Update a group of companies

curl --request POST \
  --url https://api.hubapi.com/companies/v1/batch-async/update \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "objectId": "<string>",
    "properties": [
      {
        "name": "<string>",
        "value": "<string>"
      }
    ]
  }
]
'

[
  {
    "objectId": 17433026,
    "properties": [
      {
        "name": "name",
        "value": "Updated Company Name"
      }
    ]
  },
  {
    "objectId": 16962705,
    "properties": [
      {
        "name": "name",
        "value": "Biotech Company Name"
      },
      {
        "name": "industry",
        "value": "Biotechnology"
      }
    ]
  }
]

Companies v1

Update a group of companies

Update a group of existing company records by their companyId. This endpoint takes a list of objectIds and that correspond to the companyId of the company you want to update, and a list of properties to update for that company. Note: - This endpoint can only be used to update existing company records based on their companyId. It cannot create new records

Up to 100 companies can be updated in a single request. There is no limit to the number of properties that can be updated per company.
If there are any errors in the request, the entire request will fail and no updates will be applied to any records.
The updates are processed asynchronously, so it may take several minutes to see the updates in HubSpot if you’re sending a large number of updates.

POST

companies

batch-async

update

Update a group of companies

curl --request POST \
  --url https://api.hubapi.com/companies/v1/batch-async/update \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "objectId": "<string>",
    "properties": [
      {
        "name": "<string>",
        "value": "<string>"
      }
    ]
  }
]
'

[
  {
    "objectId": 17433026,
    "properties": [
      {
        "name": "name",
        "value": "Updated Company Name"
      }
    ]
  },
  {
    "objectId": 16962705,
    "properties": [
      {
        "name": "name",
        "value": "Biotech Company Name"
      },
      {
        "name": "industry",
        "value": "Biotechnology"
      }
    ]
  }
]

Scope requirements

Body

application/json

objectId

string

required

The companyId of the company that you want to update.

properties

object[]

required

A list of properties that you want to update. Each property must include the name of the property to be updated, and the value of the property to update to.

Show child attributes

Response

202 - application/json

Successful response - Update a group of existing company records by their companyId

The response is of type object.

Last modified on December 12, 2025

⌘I