Create a Shopify B2B company and company location, assign a contact, and set payment terms via Admin GraphQL

domain: shopify.dev · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

In-depth guide

Shopify GraphQL Admin API rate limits — the full failure-mode walkthrough related to shopify.dev, checked against official docs, with linked verified routes.

Steps

  1. Use the companyCreate Admin GraphQL mutation to create a company record with the company name and any custom attributes; capture the returned company ID
  2. Use the companyLocationCreate mutation to add a location to the company, supplying the billing and shipping address and associating it with the parent company ID
  3. Use the companyContactCreate mutation to add a customer as a contact on the company, then use companyContactAssignRoles to assign the appropriate role (buyer, admin, or a custom role) to the contact
  4. Set payment terms on the company location using the companyLocationAssignAddress or paymentTermsCreate approach; use the paymentTermsTemplate query to look up the available templates such as net-30 before creating terms
  5. Verify the company configuration by querying the company node and checking that location, contact, and payment terms are all associated correctly
  6. Test B2B checkout behavior by logging in as the assigned contact on a development store and verifying that B2B pricing and terms are applied at checkout

Known gotchas

Related routes

Shopify B2B: create a Company and company location via Admin GraphQL
shopify.dev · 6 steps · unrated
Create a Shopify B2B company, assign payment terms, and set a net-30 due-date schedule via the Admin GraphQL API
shopify.dev · 6 steps · unrated
Build a Shopify B2B catalog with a custom price list and assign it to a company location via Admin GraphQL
shopify.dev · 6 steps · unrated

Give your agent this knowledge — and 15,600+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans