Skip to content

Conversation

@bc-Vince
Copy link
Contributor

@bc-Vince bc-Vince commented Dec 10, 2025

Created a new guide for Company Account Registration in the GraphQL Storefront API, detailing workflows for guest and existing customers, related queries, and considerations for new Company accounts.

DEVDOCS-6508

What changed?

  • There is now a guide for Company account registration in stores using the B2B Edition GraphQL Storefront API.

Release notes draft

  • We have published a guide that covers the B2B Edition GraphQL Storefront API queries and mutations involved in registering new Company accounts in the Buyer Portal experience.

Anything else?

ping

…low in B2B Edition's GrapQL APIs

Created a new guide for Company Account Registration in the GraphQL Storefront API, detailing workflows for guest and existing customers, related queries, and considerations for new Company accounts.
@bc-Vince bc-Vince requested a review from bc-terra December 11, 2025 15:19
@bc-Vince bc-Vince added the ready for review This PR is complete and awaiting a review. label Dec 11, 2025
@bc-Vince bc-Vince marked this pull request as ready for review December 11, 2025 15:19

Guest users do not have an existing customer account with login credentials. As a result, the requests involved in the [guest registration workflow](#registration-for-guest-users) can be performed anonymously without a token in the Authorization header.

The [registration workflow for existing customers](#registration-for-existing-storefront-customers) passes a storefront authToken to the Authorization header. This is a Bearer token generated via the `login` mutation following customer login. While it is included in the header of all B2B Edition GraphQL queries and mutations in the flow, it is only required for the `customer` query, which is a proxy request to the [BigCommerce GraphQL Storefront API](https://developer.bigcommerce.com/docs/storefront/graphql). This request uses the following endpoint: `https://api-b2b.bigcommerce.com/api/v3/proxy/bc-storefront/graphql`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The phrasing "it is only required for the customer query" made it sound to me like you meant that's the only query in all of the B2B GraphQL API that requires it. (There are, of course, many queries and mutations in the B2B GraphQL that require an auth token.) I think this actually meant it's the only query in this flow that requires it, but some re-wording might avoid confusion.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ready for review This PR is complete and awaiting a review.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants