Update Company
Updates a Company’s attributes.
If you have configured required information fields in your store’s Extra Fields settings for Company accounts or Company users, you must include the field’s name and value in the `extraFields` array of the request body. For more information on extra fields, see [B2B Edition Settings](https://support.bigcommerce.com/s/article/B2B-Edition-Settings) in the Help Center.
### Independent vs. Dependent Companies Behavior
This endpoint applies the same rules to the `customerGroupId` field as [Create a Company](#create-a-company), based on the Company behavior used in your store. Additionally, the `priceListAssign` field is not compatible with Independent Companies behavior because a Company’s price list is configured from its assigned customer group.
If your store is using Dependent Companies behavior, use the `priceListAssign` field to assign a price list to the Company account.
Authentication
X-Auth-Tokenstring
### Authentication header
| Header | Argument | Description |
|:-------|:---------|:------------|
| `X-Auth-Token` | `access_token` | For more about API accounts that generate `access_token`s, see our [Guide to API Accounts](/developer/docs/overview/api-accounts). |
### Further reading
For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/developer/docs/overview/api-accounts#x-auth-token-header-example-requests).
For more about BigCommerce OAuth scopes, see our [Guide to API Accounts](/developer/docs/overview/api-accounts#oauth-scopes).
For a list of API status codes, see [API Status Codes](/developer/api-reference/rest/overview#rest-http-status-codes).
OR
X-Store-Hashstring
### Authentication header
| Header | Argument | Description |
|:-------|:---------|:------------|
| `X-Store-Hash` | `store_hash` | The unique store hash associated with a BigCommerce store that has B2B Edition enabled. |
Path parameters
companyId
Request
This endpoint expects an object.
address
The first line of the address.
apartment
The second line of the address.
city
The city of the primary address for the Company account.
companyEmail
The primary email address for the Company account.
companyName
companyPhone
The primary phone number for the Company account.
country
The country of the primary address for the Company account. This must be either the full name or the ISO2 country code.
customerGroupId
The ID of the BigCommerce customer group assigned to the Company account. This field can be static or configurable depending on whether or not your store uses Independent Companies behavior. See Independent Companies Behavior for more information.
extraFields
To use customized extra fields with field names you need to first add company extra fields in Settings > Extra fields inside B2B edition.
e.g., If you want to create a new company with an extra integer field named licenseNO, you can use this structure [{‘fieldName’: ‘LicenseNO’, ‘fieldValue’: 10342340323}] in the request body.
priceListAssign
Use this array to assign a price list to a Company account if your store uses legacy Dependent Companies behavior *and* it has Multi-Storefront enabled. Use catalogId to assign price lists if you have not enabled Multi-Storefront.
This field is read-only for stores using Independent Companies behavior. See [Independent Companies Behavior](/developer/api-reference/rest/b2b/management/companies#independent-vs-dependent-companies-behavior) for more information.
state
The state of the primary address for the Company account, if applicable. This must be the full name and not an abbreviation.
uuid
An external ID assigned to the Company account in a third-party system, such as an ERP. Leave this field blank if you do not have an external system.
zipCode
The postal code on the address.
Response
OK
code
meta
data
Errors
404
Not Found Error
