--- title: BusinessCustomerUserError - GraphQL Admin description: An error that happens during the execution of a business customer mutation. api_version: 2025-10 api_name: admin type: object api_type: graphql source_url: html: >- https://shopify.dev/docs/api/admin-graphql/latest/objects/BusinessCustomerUserError md: >- https://shopify.dev/docs/api/admin-graphql/latest/objects/BusinessCustomerUserError.md --- # Business​Customer​User​Error object Requires `read_customers` access scope or `read_companies` access scope. An error that happens during the execution of a business customer mutation. ## Fields * code [Business​Customer​Error​Code](https://shopify.dev/docs/api/admin-graphql/latest/enums/BusinessCustomerErrorCode) The error code. * field [\[String!\]](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) The path to the input field that caused the error. * message [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The error message. *** ## Map No referencing types *** ## Mutations * [companies​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companiesDelete) mutation Deletes a list of companies. * [company​Address​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyAddressDelete) mutation Deletes a company address. * [company​Assign​Customer​As​Contact](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyAssignCustomerAsContact) mutation Adds an existing [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) as a contact to a [`Company`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Company). Companies are business entities that make purchases from the merchant's store. Use this mutation when you have a customer who needs to be associated with a B2B company to make purchases on behalf of that company. The mutation returns the newly created [`CompanyContact`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyContact) that links the customer to the company. After assignment, the customer becomes a company contact who can place orders on behalf of the company with access to any catalogs, pricing, and payment terms configured for the company's locations. * [company​Assign​Main​Contact](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyAssignMainContact) mutation Assigns the main contact for the company. * [company​Contact​Assign​Role](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyContactAssignRole) mutation Assigns a role to a contact for a location. * [company​Contact​Assign​Roles](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyContactAssignRoles) mutation Assigns roles on a company contact. * [company​Contact​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyContactCreate) mutation Creates a company contact and the associated customer. * [company​Contact​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyContactDelete) mutation Deletes a company contact. * [company​Contact​Remove​From​Company](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyContactRemoveFromCompany) mutation Removes a company contact from a Company. * [company​Contact​Revoke​Role](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyContactRevokeRole) mutation Revokes a role on a company contact. * [company​Contact​Revoke​Roles](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyContactRevokeRoles) mutation Revokes roles on a company contact. * [company​Contacts​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyContactsDelete) mutation Deletes one or more company contacts. * [company​Contact​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyContactUpdate) mutation Updates a company contact. * [company​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyCreate) mutation Creates a [`Company`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Company) for B2B commerce. This mutation creates the company and can optionally create an initial [`CompanyContact`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyContact) and [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocation) in a single operation. Company contacts are people who place orders on behalf of the company. Company locations are branches or offices with their own billing and shipping addresses. *** Note Creating a company without a `name` [returns an error](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companycreate?example=creating-a-company-without-a-name-returns-an-error). *** Learn more about [creating companies for B2B](https://shopify.dev/docs/apps/build/b2b/start-building#step-1-create-a-company). * [company​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyDelete) mutation Deletes a company. * [company​Location​Assign​Address](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationAssignAddress) mutation Updates an address on a company location. * [company​Location​Assign​Roles](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationAssignRoles) mutation Assigns roles on a company location. * [company​Location​Assign​Staff​Members](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationAssignStaffMembers) mutation Creates one or more mappings between a staff member at a shop and a company location. * [company​Location​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationCreate) mutation Creates a new location for a [`Company`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Company). Company locations are branches or offices where B2B customers can place orders with specific pricing, catalogs, and payment terms. Creates a company location. Each location can have its own billing and shipping addresses, tax settings, and [`buyer experience configuration`](https://shopify.dev/docs/api/admin-graphql/latest/objects/BuyerExperienceConfiguration). You can assign [staff members](https://shopify.dev/docs/api/admin-graphql/latest/objects/StaffMember) and [`CompanyContact`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyContact) objects to manage the location. * [company​Location​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationDelete) mutation Deletes a company location. * [company​Location​Remove​Staff​Members](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationRemoveStaffMembers) mutation Deletes one or more existing mappings between a staff member at a shop and a company location. * [company​Location​Revoke​Roles](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationRevokeRoles) mutation Revokes roles on a company location. * [company​Locations​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationsDelete) mutation Deletes a list of company locations. * [company​Location​Tax​Settings​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationTaxSettingsUpdate) mutation Sets the tax settings for a company location. * [company​Location​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationUpdate) mutation Updates a company location's information and B2B checkout settings. Company locations are branches or offices where [`CompanyContact`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyContact) members place orders on behalf of the company. Contacts must be assigned to a location through `roleAssignments` to place orders. The mutation modifies details such as the location's name, contact information, preferred locale, and internal notes. You can also configure the B2B checkout experience through [`BuyerExperienceConfiguration`](https://shopify.dev/docs/api/admin-graphql/latest/objects/BuyerExperienceConfiguration) settings that control whether orders require merchant review, [`PaymentTermsTemplate`](https://shopify.dev/docs/api/admin-graphql/latest/objects/PaymentTermsTemplate) settings, shipping address editing permissions, and [`DepositConfiguration`](https://shopify.dev/docs/api/admin-graphql/latest/unions/DepositConfiguration) requirements. Learn more about [managing company locations](https://shopify.dev/docs/apps/build/b2b/manage-client-company-locations). * [company​Revoke​Main​Contact](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyRevokeMainContact) mutation Revokes the main contact from the company. * [company​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyUpdate) mutation 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). ### Deprecated mutations * [company​Location​Assign​Tax​Exemptions](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationAssignTaxExemptions) mutation Deprecated * [company​Location​Create​Tax​Registration](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationCreateTaxRegistration) mutation Deprecated * [company​Location​Revoke​Tax​Exemptions](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationRevokeTaxExemptions) mutation Deprecated * [company​Location​Revoke​Tax​Registration](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationRevokeTaxRegistration) mutation Deprecated *** ## <\~> BusinessCustomerUserError Mutations ### Mutated by * <\~>[companies​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companiesDelete) * <\~>[company​Address​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyAddressDelete) * <\~>[company​Assign​Customer​As​Contact](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyAssignCustomerAsContact) * <\~>[company​Assign​Main​Contact](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyAssignMainContact) * <\~>[company​Contact​Assign​Role](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyContactAssignRole) * <\~>[company​Contact​Assign​Roles](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyContactAssignRoles) * <\~>[company​Contact​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyContactCreate) * <\~>[company​Contact​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyContactDelete) * <\~>[company​Contact​Remove​From​Company](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyContactRemoveFromCompany) * <\~>[company​Contact​Revoke​Role](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyContactRevokeRole) * <\~>[company​Contact​Revoke​Roles](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyContactRevokeRoles) * <\~>[company​Contact​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyContactUpdate) * <\~>[company​Contacts​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyContactsDelete) * <\~>[company​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyCreate) * <\~>[company​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyDelete) * <\~>[company​Location​Assign​Address](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationAssignAddress) * <\~>[company​Location​Assign​Roles](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationAssignRoles) * <\~>[company​Location​Assign​Staff​Members](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationAssignStaffMembers) * <\~>[company​Location​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationCreate) * <\~>[company​Location​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationDelete) * <\~>[company​Location​Remove​Staff​Members](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationRemoveStaffMembers) * <\~>[company​Location​Revoke​Roles](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationRevokeRoles) * <\~>[company​Location​Tax​Settings​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationTaxSettingsUpdate) * <\~>[company​Location​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationUpdate) * <\~>[company​Locations​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationsDelete) * <\~>[company​Revoke​Main​Contact](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyRevokeMainContact) * <\~>[company​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyUpdate) *** ## Interfaces * [Displayable​Error](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/DisplayableError) interface *** ## ||-BusinessCustomerUserError Implements ### Implements * ||-[Displayable​Error](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/DisplayableError)