Company - Contact Assign Roles¶
The Company - Contact Assign Roles push gives a company contact a role at one of the company's locations. The role decides what the contact can do there, such as Location admin or Ordering only. Each record assigns one role.
On a push connector, select Company - Contact Assign Roles as the Shopify Import Type. The push sends each record through Shopify's companyContactAssignRole mutation. See Building a B2B Customer for where it fits.
Fields¶
| Field | Rule | Where the id comes from |
|---|---|---|
| Contact Id | Required. The contact, as a gid such as gid://shopify/CompanyContact/1234567890 |
Company - Assign Customer As Contacts writes it back |
| Contact Role Id | Required. The role, as a gid such as gid://shopify/CompanyContactRole/1234567890 |
Company Locations writes back the Location admin role's id. Companies writes back the company's first two roles |
| Location Id | Required. The location, as a gid such as gid://shopify/CompanyLocation/1234567890 |
Companies and Company Locations write it back |
Give each id as a gid. Each record is an insert, and the push writes nothing back.
Access Scopes¶
The push needs write_companies. See Access Scopes.
Shopify Reference¶
companyContactAssignRole in Shopify's GraphQL Admin API reference.