---
title: companyAssignCustomerAsContact - GraphQL Admin
description: >-
  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.
api_version: 2025-10
api_name: admin
type: mutation
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyAssignCustomerAsContact
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyAssignCustomerAsContact.md
---

# company​Assign​Customer​As​Contact

mutation

Requires `write_customers` access scope or `write_companies` access scope. Also: The API client must be installed on a Shopify Plus store.

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.

## Arguments

* company​Id

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

  required

  The ID of the company to assign the contact to.

* customer​Id

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

  required

  The ID of the customer to assign as the contact.

***

## Company​Assign​Customer​As​Contact​Payload returns

* company​Contact

  [Company​Contact](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyContact)

  The created company contact.

* user​Errors

  [\[Business​Customer​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/BusinessCustomerUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### companyAssignCustomerAsContact reference

## Mutation Reference

```graphql
mutation companyAssignCustomerAsContact($companyId: ID!, $customerId: ID!) {
  companyAssignCustomerAsContact(companyId: $companyId, customerId: $customerId) {
    companyContact {
      # CompanyContact fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

##### Variables

```json
{
  "companyId": "gid://shopify/<objectName>/10079785100",
  "customerId": "gid://shopify/<objectName>/10079785100"
}
```