Skip to content

Business units GraphQL

Served by BusinessUnitModule on commercetools, BusinessUnitModule on medusa and BusinessUnitModule on sfcc.

Each operation has its own page with its arguments, an example and the engines that serve it. The types link to their fields on the business units types page.

Operations

OperationDescriptionServed by
businessUnitQueryGet a specific business unit by IDcommercetoolsmedusasfcc
businessUnitsQueryGet all business units accessible to the current usercommercetoolsmedusasfcc
businessUnitAddressCreateMutationAdd a new address to a business unitcommercetoolsmedusasfcc
businessUnitAddressDeleteMutationRemove an address from a business unitcommercetoolsmedusasfcc
businessUnitAddressUpdateMutationUpdate an existing address in a business unitcommercetoolsmedusasfcc
businessUnitAssociateActivateMutationActivate a previously deactivated associate, restoring their ability to act within the business unit.commercetoolsmedusasfcc
businessUnitAssociateDeactivateMutationDeactivate an associate so they can no longer act within the business unit.commercetoolsmedusasfcc
businessUnitAssociateInviteMutationInvite a new associate to the business unit with specified rolescommercetoolsmedusasfcc
businessUnitAssociateRemoveMutationRemove an associate from the business unitcommercetoolsmedusasfcc
businessUnitAssociateRolesUpdateMutationUpdate associate roles for an existing associate in the business unit Note: All current roles will be replaced with the provided rolescommercetoolsmedusasfcc
businessUnitDefaultAddressUpdateMutationSet the business unit's default shipping and/or billing address by referencing an existing address in its address book.commercetoolsmedusasfcc
businessUnitSwitchMutationSet the active business context for B2B operationscommercetoolsmedusasfcc

Types

TypeDescription
BusinessUnitObject
BusinessUnitAddressCreateErrorUnion
BusinessUnitAddressCreateResponseObject
BusinessUnitAddressDeleteErrorUnion
BusinessUnitAddressDeleteResponseObject
BusinessUnitAddressUpdateErrorUnion
BusinessUnitAddressUpdateResponseObject
BusinessUnitAssociateObjectCustomer associated with a business unit, including their assigned roles
BusinessUnitAssociateInviteErrorUnion
BusinessUnitAssociateInviteResponseObject
BusinessUnitAssociateRemoveErrorUnion
BusinessUnitAssociateRemoveResponseObject
BusinessUnitAssociateResultObjectPaginated result containing business unit associates
BusinessUnitAssociateRolesUpdateErrorUnion
BusinessUnitAssociateRolesUpdateResponseObject
BusinessUnitAssociateStatusTypeEnumWhether an associate is active or has been deactivated within a unit
BusinessUnitAssociateStatusUpdateErrorUnion
BusinessUnitAssociateStatusUpdateResponseObject
BusinessUnitCapabilityTypeEnumNormalized, engine-agnostic capabilities a role grants within a business unit.
BusinessUnitCreditObjectA company's credit on account, in the currency of its limit.
BusinessUnitDefaultAddressUpdateErrorUnion
BusinessUnitDefaultAddressUpdateResponseObject
BusinessUnitErrorObjectA change to a business unit the caller may not make.
BusinessUnitErrorCodeTypeEnumWhy a change to a business unit was refused.
BusinessUnitInvitationObjectAn invitation to someone who has yet to set up their account.
BusinessUnitInvitationResultObjectPaginated result containing a business unit's pending invitations
BusinessUnitPaymentTermsObjectWhen a company pays for what it buys on account.
BusinessUnitRoleObjectRoles that can be assigned to customers in a business unit