GraphQL Schema Updates

The B2B GraphQL quoteEmail mutation can now send a quote using a custom PDF template and a custom subject line.

B2B GraphQL

  • Custom quote emails: two optional fields on the QuoteEmailInputType input.
    • Template: templateId takes the UUID of a custom quote PDF template. When omitted, the legacy send path is used.
    • Subject: subject sets a send-time subject line. When omitted, the template’s default subject is used.

For schema details, browse the B2B GraphQL API reference.


Rewritten single-click app tutorial

The single-click app tutorial is rebuilt around a new Next.js starter app that takes you from a mock-data UI to a fully authenticated, multitenant app storing encrypted per-store tokens.

  • Modernized stack — the tutorial and its starter app use the Next.js App Router, React 19, BigDesign 5, pnpm, and Node.js 24, replacing the previous sample app.
  • Dependency-free local setup — SQLite is the default credentials store, created automatically as a local file, so there is no external database to provision before the first install.
  • Production-ready patterns — stored access tokens are encrypted at rest, the app’s own session cookie is signed separately from BigCommerce’s inbound signed payloads, and the OAuth redirect_uri is pinned to a configured origin rather than derived from the request.
  • Hosting support - scaffolding and a Postgres driver that makes the app ready for deployment to Vercel.
  • Flexible development and deployment — three data modes (MOCK, STATIC, MULTITENANT) let you build the UI before wiring up auth, and a pluggable credentials-store driver swaps SQLite for a production driver when you deploy.
  • Five-part structure — build a BigDesign UI, integrate BigCommerce data, add single-click authentication, manage sessions, and persist to a database, building a working gift certificates manager throughout.
  • Refreshed Quick Start — the Apps Quick Start now covers the new starter app’s setup: pnpm and Node.js 24, the /api/app/* callback URLs, the environment variables that replace the old database and JWT settings, and the OAuth scopes the app requires.
  • Updated app extensions guide — the App Extensions guide no longer repeats the draft app setup steps, and instead focuses on creating an app profile before linking to the Quick Start.
  • Sample app references updated — 14 pages across the apps guides, app extensions docs, and tools and SDKs list now point to the new starter app repository in place of the retired sample-app-nodejs.

For details, see the single-click app tutorial and the Apps Quick Start.