Choose a version:

CompanyContact

object

Requires read_customers access scope or read_companies access scope. Also: The API client must be installed on a Shopify Plus store.

A person who acts on behalf of a Company to make B2B purchases. Company contacts are associated with Customer accounts and can place orders on behalf of their company.

Each contact can be assigned to one or more CompanyLocation objects with specific roles that determine their permissions and access to catalogs, pricing, and payment terms configured for those locations.

Anchor to FieldsFields

Anchor to companycompany •Company! non-null: The company to which the contact belongs.
Anchor to createdAtcreatedAt •DateTime! non-null: The date and time (ISO 8601 format) at which the company contact was created at Shopify.
Anchor to customercustomer •Customer! non-null: The customer associated to this contact.
Anchor to draftOrdersdraftOrders •DraftOrderConnection! non-null: The list of draft orders for the company contact.
Anchor to idid •ID! non-null: A globally-unique ID.
Anchor to isMainContactisMainContact •Boolean! non-null: Whether the contact is the main contact of the company.
Anchor to lifetimeDurationlifetimeDuration •String! non-null: The lifetime duration of the company contact, since its creation date on Shopify. Examples: 1 year, 2 months, 3 days.
Anchor to localelocale •String: The company contact's locale (language).
Anchor to ordersorders •OrderConnection! non-null: The list of orders for the company contact.
Anchor to roleAssignmentsroleAssignments •CompanyContactRoleAssignmentConnection! non-null: The list of roles assigned to this company contact.
Anchor to titletitle •String: The company contact's job title.
Anchor to updatedAtupdatedAt •DateTime! non-null: The date and time (ISO 8601 format) at which the company contact was last updated.

Was this section helpful?

Anchor to QueriesQueries

Anchor to companyContact companyContact •query: Returns a CompanyContact resource by ID.

Was this section helpful?

Anchor to MutationsMutations

Anchor to companyAssignCustomerAsContact companyAssignCustomerAsContact •mutation: Adds an existing Customer as a contact to a Company. Companies are business entities that make purchases from the merchant's store. Use this mutation when you have a customer who needs to be associated with a B2B company to make purchases on behalf of that company.

The mutation returns the newly created CompanyContact that links the customer to the company. After assignment, the customer becomes a company contact who can place orders on behalf of the company with access to any catalogs, pricing, and payment terms configured for the company's locations.
Anchor to companyContactCreate companyContactCreate •mutation: Creates a company contact and the associated customer.
Anchor to companyContactUpdate companyContactUpdate •mutation: Updates a company contact.

Was this section helpful?

Anchor to InterfacesInterfaces

Anchor to Node Node •interface

Was this section helpful?