---
title: CompanyContact - GraphQL Admin
description: >-
  A person who acts on behalf of a
  [`Company`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Company)
  to make B2B purchases. Company contacts are associated with
  [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer)
  accounts and can place orders on behalf of their company.


  Each contact can be assigned to one or more
  [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocation)
  objects with specific roles that determine their permissions and access to
  catalogs, pricing, and payment terms configured for those locations.
api_version: unstable
api_name: admin
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyContact'
  md: >-
    https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyContact.md
---

# Company​Contact

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`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Company) to make B2B purchases. Company contacts are associated with [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) accounts and can place orders on behalf of their company.

Each contact can be assigned to one or more [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocation) objects with specific roles that determine their permissions and access to catalogs, pricing, and payment terms configured for those locations.

## Fields

* company

  [Company!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company)

  non-null

  The company to which the contact belongs.

* created​At

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/DateTime)

  non-null

  The date and time ([ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601)) at which the company contact was created at Shopify.

* customer

  [Customer!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Customer)

  non-null

  The customer associated to this contact.

* draft​Orders

  [Draft​Order​Connection!](https://shopify.dev/docs/api/admin-graphql/unstable/connections/DraftOrderConnection)

  non-null

  The list of draft orders for the company contact.

  * first

    [Int](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/Int)

    ### Arguments

    The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * after

    [String](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String)

    The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * last

    [Int](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/Int)

    The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * before

    [String](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String)

    The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * reverse

    [Boolean](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/Boolean)

    Default:false

    Reverse the order of the underlying list.

  * sort​Key

    [Draft​Order​Sort​Keys](https://shopify.dev/docs/api/admin-graphql/unstable/enums/DraftOrderSortKeys)

    Default:ID

    Sort the underlying list using a key. If your query is slow or returns an error, then [try specifying a sort key that matches the field used in the search](https://shopify.dev/api/usage/pagination-graphql#search-performance-considerations).

  * query

    [String](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String)

    A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about [Shopify API search syntax](https://shopify.dev/api/usage/search-syntax).

    * * default

        string

      * created\_at

        time

      - Filter by a case-insensitive search of multiple fields in a document.

      - Example:
        * `query=Bob Norman`
        * `query=title:green hoodie`

    * customer\_id

      id

    * * id

        id

      * source

        string

      - Filter by `id` range.

      - Example:
        * `id:1234`
        * `id:>=1234`
        * `id:<=1234`

    * status

      string

    * tag

      string

    * updated\_at

      time

  ***

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/ID)

  non-null

  A globally-unique ID.

* is​Main​Contact

  [Boolean!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/Boolean)

  non-null

  Whether the contact is the main contact of the company.

* lifetime​Duration

  [String!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String)

  non-null

  The lifetime duration of the company contact, since its creation date on Shopify. Examples: `1 year`, `2 months`, `3 days`.

* locale

  [String](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String)

  The company contact's locale (language).

* orders

  [Order​Connection!](https://shopify.dev/docs/api/admin-graphql/unstable/connections/OrderConnection)

  non-null

  The list of orders for the company contact.

  * first

    [Int](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/Int)

    ### Arguments

    The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * after

    [String](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String)

    The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * last

    [Int](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/Int)

    The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * before

    [String](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String)

    The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * reverse

    [Boolean](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/Boolean)

    Default:false

    Reverse the order of the underlying list.

  * sort​Key

    [Order​Sort​Keys](https://shopify.dev/docs/api/admin-graphql/unstable/enums/OrderSortKeys)

    Default:ID

    Sort the underlying list using a key. If your query is slow or returns an error, then [try specifying a sort key that matches the field used in the search](https://shopify.dev/api/usage/pagination-graphql#search-performance-considerations).

  ***

* role​Assignments

  [Company​Contact​Role​Assignment​Connection!](https://shopify.dev/docs/api/admin-graphql/unstable/connections/CompanyContactRoleAssignmentConnection)

  non-null

  The list of roles assigned to this company contact.

  * first

    [Int](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/Int)

    ### Arguments

    The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * after

    [String](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String)

    The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * last

    [Int](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/Int)

    The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * before

    [String](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String)

    The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * reverse

    [Boolean](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/Boolean)

    Default:false

    Reverse the order of the underlying list.

  * sort​Key

    [Company​Contact​Role​Assignment​Sort​Keys](https://shopify.dev/docs/api/admin-graphql/unstable/enums/CompanyContactRoleAssignmentSortKeys)

    Default:ID

    Sort the underlying list by the given key.

  * query

    [String](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String)

    A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about [Shopify API search syntax](https://shopify.dev/api/usage/search-syntax).

    * * default

        string

      * company\_contact\_id

        id

      - Filter by a case-insensitive search of multiple fields in a document.

      - Example:
        * `query=Bob Norman`
        * `query=title:green hoodie`

    * company\_contact\_role\_id

      id

    * company\_id

      id

    * company\_location\_id

      id

    * created\_at

      time

    * * id

        id

      * location\_name

        string

      - Filter by `id` range.

      - Example:
        * `id:1234`
        * `id:>=1234`
        * `id:<=1234`

    * role\_name

      string

    * updated\_at

      time

  ***

* title

  [String](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String)

  The company contact's job title.

* updated​At

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/DateTime)

  non-null

  The date and time ([ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601)) at which the company contact was last updated.

***

## Map

### Fields and connections with this object

* [Company.contacts](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company#field-Company.fields.contacts)
* [Company.mainContact](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Company#field-Company.fields.mainContact)
* [CompanyContactConnection.nodes](https://shopify.dev/docs/api/admin-graphql/unstable/connections/CompanyContactConnection#returns-nodes)
* [CompanyContactEdge.node](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyContactEdge#field-CompanyContactEdge.fields.node)
* [CompanyContactRoleAssignment.companyContact](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyContactRoleAssignment#field-CompanyContactRoleAssignment.fields.companyContact)
* [Customer.companyContactProfiles](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Customer#field-Customer.fields.companyContactProfiles)
* [PurchasingCompany.contact](https://shopify.dev/docs/api/admin-graphql/unstable/objects/PurchasingCompany#field-PurchasingCompany.fields.contact)

***

## Queries

* [company​Contact](https://shopify.dev/docs/api/admin-graphql/unstable/queries/companyContact)

  query

  Returns a `CompanyContact` resource by ID.

  * id

    [ID!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/ID)

    required

    ### Arguments

    The ID of the `CompanyContact` to return.

  ***

***

## CompanyContact Queries

### Queried by

* [company​Contact](https://shopify.dev/docs/api/admin-graphql/unstable/queries/companyContact)

***

## Mutations

* [company​Assign​Customer​As​Contact](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/companyAssignCustomerAsContact)

  mutation

  Adds an existing [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) as a contact to a [`Company`](https://shopify.dev/docs/api/admin-graphql/latest/objects/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`](https://shopify.dev/docs/api/admin-graphql/latest/objects/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.

  * company​Id

    [ID!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/ID)

    required

    ### Arguments

    The ID of the company to assign the contact to.

  * customer​Id

    [ID!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/ID)

    required

    The ID of the customer to assign as the contact.

  ***

* [company​Contact​Create](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/companyContactCreate)

  mutation

  Creates a company contact and the associated customer.

  * company​Id

    [ID!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/ID)

    required

    ### Arguments

    The ID of the company that the company contact belongs to.

  * input

    [Company​Contact​Input!](https://shopify.dev/docs/api/admin-graphql/unstable/input-objects/CompanyContactInput)

    required

    The fields to use to create the company contact.

  ***

* [company​Contact​Update](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/companyContactUpdate)

  mutation

  Updates a company contact.

  * company​Contact​Id

    [ID!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/ID)

    required

    ### Arguments

    The ID of the company contact to be updated.

  * input

    [Company​Contact​Input!](https://shopify.dev/docs/api/admin-graphql/unstable/input-objects/CompanyContactInput)

    required

    The fields to use to update the company contact.

  ***

***

## CompanyContact Mutations

### Mutated by

* [company​Assign​Customer​As​Contact](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/companyAssignCustomerAsContact)
* [company​Contact​Create](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/companyContactCreate)
* [company​Contact​Update](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/companyContactUpdate)

***

## Interfaces

* [Node](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/Node)

  interface

***

## CompanyContact Implements

### Implements

* [Node](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/Node)