Documentation
All Release Notes
Introduced GraphQL support for creating Associates using My Business Units
6 June 2023
Composable Commerce
HTTP API
Enhancement
B2BGraphQL

We introduced GraphQL support for creating Associates using My Business Units. This allows Customers with the UpdateAssociates Permission to create a new Associate, assigning them roles specific to the given Business Unit.

Changes:

  • [GraphQL API] Added the following types to the GraphQL schema: SignUpInMyBusinessUnitDraft.
  • [GraphQL API] Changed the Mutation type:
    • Added the signUpInMyBusinessUnit field to the Mutation type.

The following changes were introduced in terms of GraphQL SDL:

extend type Mutation {
  "BETA: This feature can be subject to change and should be used carefully in production. https://docs.commercetools.com/api/contract#public-beta Signs up a new customer and associates it with the business unit."
  signUpInMyBusinessUnit(draft: SignUpInMyBusinessUnitDraft!): CustomerSignInResult!
}

input SignUpInMyBusinessUnitDraft {
  businessUnit: ResourceIdentifierInput!
  customer: CustomerSignUpDraft!
  version: Long!
  associateRoleAssignments: [AssociateRoleAssignmentDraft!]!
}