---
title: companyUpdate - GraphQL Admin
description: |-
  Updates a [`Company`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Company)
  with new information. Companies represent business customers that can have
  multiple contacts and locations with specific pricing, payment terms, and
  checkout settings.

  The mutation accepts the company's ID and an input object containing the
  fields to update. You can modify the company name, add or update internal
  notes, set an external ID for integration with other systems, or adjust the
  customer relationship start date.

  Learn more about [building B2B features](https://shopify.dev/docs/apps/build/b2b/start-building).
api_version: 2026-07
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyupdate
  md: https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyupdate.md
---

# company​Update

mutation

Requires `write_customers` access scope or `write_companies` access scope. Also: The shop must have access to B2B. Some operations may require additional plan capabilities.

Updates a [`Company`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Company) with new information. Companies represent business customers that can have multiple contacts and locations with specific pricing, payment terms, and checkout settings.

The mutation accepts the company's ID and an input object containing the fields to update. You can modify the company name, add or update internal notes, set an external ID for integration with other systems, or adjust the customer relationship start date.

Learn more about [building B2B features](https://shopify.dev/docs/apps/build/b2b/start-building).

## Arguments

* company​Id

  [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  required

  The ID of the company to be updated.

* input

  [Company​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CompanyInput)

  required

  The input fields to update the company.

***

## Company​Update​Payload returns

* company

  [Company](https://shopify.dev/docs/api/admin-graphql/latest/objects/Company)

  The updated company.

* user​Errors

  [\[Business​Customer​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/BusinessCustomerUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### companyUpdate reference