---
title: companyUpdate - GraphQL Admin
description: Updates a company.
api_version: 2025-10
api_name: admin
type: mutation
api_type: graphql
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 API client must be installed on a Shopify Plus store.

Updates a company.

## 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

## Mutation Reference

```graphql
mutation companyUpdate($companyId: ID!, $input: CompanyInput!) {
  companyUpdate(companyId: $companyId, input: $input) {
    company {
      # Company fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

```json
{
  "companyId": "gid://shopify/<objectName>/10079785100",
  "input": {
    "name": "<your-name>",
    "note": "<your-note>",
    "externalId": "<your-externalId>",
    "customerSince": "2019-09-07T15:50:00Z"
  }
}
```

##### Variables

```
{
  "companyId": "gid://shopify/<objectName>/10079785100",
  "input": {
    "name": "<your-name>",
    "note": "<your-note>",
    "externalId": "<your-externalId>",
    "customerSince": "2019-09-07T15:50:00Z"
  }
}
```

##### Schema

```
input CompanyInput {
  name: String
  note: String
  externalId: String
  customerSince: DateTime
}
```