B2B Multiple Customer Contacts

Topic summary

Shopify’s B2B documentation states that a customer can only belong to one company, but the API design suggests otherwise.

The Contradiction:

  • Official documentation limits customers to a single company
  • The API returns Customer.companyContacts as a list (plural), implying multiple company associations are possible
  • No direct Customer.company field exists; developers must iterate through the companyContacts list to access company data via CompanyContact.company

User Concerns:

  • The discrepancy creates confusion about Shopify’s intended approach and future direction
  • Real-world use cases exist where customers legitimately need access to place orders across multiple companies

Current Status:
The discussion remains open with speculation that the list structure may be preparing for future multi-company support, though no official clarification has been provided.

Summarized with AI on November 1. AI used: claude-sonnet-4-5-20250929.

Shopify says that a customer can only be a part of ONE company.

But the API provides Customer.companyContacts which is a list, suggesting a customer could be connected to multiple companies.

It also doesn’t provide a direct Customer.company field, you have to iterate through the companyContacts list and get the company using CompanyContact.company.

It’s just a bit confusing what the approach is going to be for the future… ?

I personally think customer accounts should be affiliated with MULTIPLE companies, as there might be some case where customers need access to place orders on multiple different companies.

1 Like

Agreed, confusing that it returns a list. Possibly in place to support future expansion