Choose a version:

companyContactCreate

mutation

Requires write_customers access scope or write_companies access scope. Also: The shop must have access to B2B. Some operations may require additional plan capabilities.

Creates a company contact and the associated customer.

Anchor to Arguments

Arguments

Anchor to companyIdcompanyId

•ID!

required

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

Anchor to inputinput

•CompanyContactInput!

required

The fields to use to create the company contact.

Was this section helpful?

Anchor to CompanyContactCreatePayload returnsCompanyContactCreatePayload returns

Anchor to companyContactcompanyContact •CompanyContact: The created company contact.
Anchor to userErrorsuserErrors •[BusinessCustomerUserError!]! non-null: The list of errors that occurred from executing the mutation.

Was this section helpful?

Examples

Create a company contact

Description

Create a company contact for the specified company.

Query

mutation CompanyContactCreate($companyId: ID!, $input: CompanyContactInput!) {
  companyContactCreate(companyId: $companyId, input: $input) {
    companyContact {
      id
      company {
        id
        name
      }
      customer {
        id
        firstName
        lastName
        email
      }
    }
    userErrors {
      field
      message
      code
    }
  }
}

Variables

{
  "companyId": "gid://shopify/Company/426793626",
  "input": {
    "email": "avery.brown@example.com",
    "firstName": "Avery",
    "lastName": "Brown"
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation CompanyContactCreate($companyId: ID!, $input: CompanyContactInput!) { companyContactCreate(companyId: $companyId, input: $input) { companyContact { id company { id name } customer { id firstName lastName email } } userErrors { field message code } } }",
 "variables": {
    "companyId": "gid://shopify/Company/426793626",
    "input": {
      "email": "avery.brown@example.com",
      "firstName": "Avery",
      "lastName": "Brown"
    }
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation CompanyContactCreate($companyId: ID!, $input: CompanyContactInput!) {
    companyContactCreate(companyId: $companyId, input: $input) {
      companyContact {
        id
        company {
          id
          name
        }
        customer {
          id
          firstName
          lastName
          email
        }
      }
      userErrors {
        field
        message
        code
      }
    }
  }`,
  {
    variables: {
        "companyId": "gid://shopify/Company/426793626",
        "input": {
            "email": "avery.brown@example.com",
            "firstName": "Avery",
            "lastName": "Brown"
        }
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation CompanyContactCreate($companyId: ID!, $input: CompanyContactInput!) {
    companyContactCreate(companyId: $companyId, input: $input) {
      companyContact {
        id
        company {
          id
          name
        }
        customer {
          id
          firstName
          lastName
          email
        }
      }
      userErrors {
        field
        message
        code
      }
    }
  }
QUERY

variables = {
  "companyId": "gid://shopify/Company/426793626",
  "input": {
    "email": "avery.brown@example.com",
    "firstName": "Avery",
    "lastName": "Brown"
  }
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation CompanyContactCreate($companyId: ID!, $input: CompanyContactInput!) {
      companyContactCreate(companyId: $companyId, input: $input) {
        companyContact {
          id
          company {
            id
            name
          }
          customer {
            id
            firstName
            lastName
            email
          }
        }
        userErrors {
          field
          message
          code
        }
      }
    }`,
    "variables": {
        "companyId": "gid://shopify/Company/426793626",
        "input": {
            "email": "avery.brown@example.com",
            "firstName": "Avery",
            "lastName": "Brown"
        }
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'mutation CompanyContactCreate($companyId: ID!, $input: CompanyContactInput!) {
  companyContactCreate(companyId: $companyId, input: $input) {
    companyContact {
      id
      company {
        id
        name
      }
      customer {
        id
        firstName
        lastName
        email
      }
    }
    userErrors {
      field
      message
      code
    }
  }
}' \
--variables \
'{
  "companyId": "gid://shopify/Company/426793626",
  "input": {
    "email": "avery.brown@example.com",
    "firstName": "Avery",
    "lastName": "Brown"
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      mutation CompanyContactCreate($companyId: ID!, $input: CompanyContactInput!) {
        companyContactCreate(companyId: $companyId, input: $input) {
          companyContact {
            id
            company {
              id
              name
            }
            customer {
              id
              firstName
              lastName
              email
            }
          }
          userErrors {
            field
            message
            code
          }
        }
      }
    `,
    variables: {
        "companyId": "gid://shopify/Company/426793626",
        "input": {
            "email": "avery.brown@example.com",
            "firstName": "Avery",
            "lastName": "Brown"
        }
    },
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "companyContactCreate": {
    "companyContact": {
      "id": "gid://shopify/CompanyContact/1059341859",
      "company": {
        "id": "gid://shopify/Company/426793626",
        "name": "Fancy Pants Inc."
      },
      "customer": {
        "id": "gid://shopify/Customer/1073339480",
        "firstName": "Avery",
        "lastName": "Brown",
        "email": "avery.brown@example.com"
      }
    },
    "userErrors": []
  }
}

companyContactCreate reference

Examples

Open in GraphiQL

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

mutation CompanyContactCreate($companyId: ID!, $input: CompanyContactInput!) {

companyContactCreate(companyId: $companyId, input: $input) {

companyContact {

company {

name

}

customer {

firstName

lastName

}

userErrors {

field

message

code

}

}`,

{

variables: {

"companyId": "gid://shopify/Company/426793626",

"input": {

"email": "avery.brown@example.com",

"firstName": "Avery",

"lastName": "Brown"

}

);

const json = await response.json();

return json.data;

}

GQL

mutation CompanyContactCreate($companyId: ID!, $input: CompanyContactInput!) {
  companyContactCreate(companyId: $companyId, input: $input) {
    companyContact {
      id
      company {
        id
        name
      }
      customer {
        id
        firstName
        lastName
        email
      }
    }
    userErrors {
      field
      message
      code
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation CompanyContactCreate($companyId: ID!, $input: CompanyContactInput!) { companyContactCreate(companyId: $companyId, input: $input) { companyContact { id company { id name } customer { id firstName lastName email } } userErrors { field message code } } }",
 "variables": {
    "companyId": "gid://shopify/Company/426793626",
    "input": {
      "email": "avery.brown@example.com",
      "firstName": "Avery",
      "lastName": "Brown"
    }
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation CompanyContactCreate($companyId: ID!, $input: CompanyContactInput!) {
    companyContactCreate(companyId: $companyId, input: $input) {
      companyContact {
        id
        company {
          id
          name
        }
        customer {
          id
          firstName
          lastName
          email
        }
      }
      userErrors {
        field
        message
        code
      }
    }
  }`,
  {
    variables: {
        "companyId": "gid://shopify/Company/426793626",
        "input": {
            "email": "avery.brown@example.com",
            "firstName": "Avery",
            "lastName": "Brown"
        }
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation CompanyContactCreate($companyId: ID!, $input: CompanyContactInput!) {
      companyContactCreate(companyId: $companyId, input: $input) {
        companyContact {
          id
          company {
            id
            name
          }
          customer {
            id
            firstName
            lastName
            email
          }
        }
        userErrors {
          field
          message
          code
        }
      }
    }`,
    "variables": {
        "companyId": "gid://shopify/Company/426793626",
        "input": {
            "email": "avery.brown@example.com",
            "firstName": "Avery",
            "lastName": "Brown"
        }
    },
  },
});

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation CompanyContactCreate($companyId: ID!, $input: CompanyContactInput!) {
    companyContactCreate(companyId: $companyId, input: $input) {
      companyContact {
        id
        company {
          id
          name
        }
        customer {
          id
          firstName
          lastName
          email
        }
      }
      userErrors {
        field
        message
        code
      }
    }
  }
QUERY

variables = {
  "companyId": "gid://shopify/Company/426793626",
  "input": {
    "email": "avery.brown@example.com",
    "firstName": "Avery",
    "lastName": "Brown"
  }
}

response = client.query(query: query, variables: variables)

Shopify CLI

shopify app execute \
--query \
'mutation CompanyContactCreate($companyId: ID!, $input: CompanyContactInput!) {
  companyContactCreate(companyId: $companyId, input: $input) {
    companyContact {
      id
      company {
        id
        name
      }
      customer {
        id
        firstName
        lastName
        email
      }
    }
    userErrors {
      field
      message
      code
    }
  }
}' \
--variables \
'{
  "companyId": "gid://shopify/Company/426793626",
  "input": {
    "email": "avery.brown@example.com",
    "firstName": "Avery",
    "lastName": "Brown"
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      mutation CompanyContactCreate($companyId: ID!, $input: CompanyContactInput!) {
        companyContactCreate(companyId: $companyId, input: $input) {
          companyContact {
            id
            company {
              id
              name
            }
            customer {
              id
              firstName
              lastName
              email
            }
          }
          userErrors {
            field
            message
            code
          }
        }
      }
    `,
    variables: {
        "companyId": "gid://shopify/Company/426793626",
        "input": {
            "email": "avery.brown@example.com",
            "firstName": "Avery",
            "lastName": "Brown"
        }
    },
  }),
});

const { data } = await response.json();
console.log(data);

Input variables

JSON

{

"companyId": "gid://shopify/Company/426793626",

"input": {

"email": "avery.brown@example.com",

"firstName": "Avery",

"lastName": "Brown"

}

Response

JSON

{

"companyContactCreate": {

"companyContact": {

"id": "gid://shopify/CompanyContact/1059341859",

"company": {

"id": "gid://shopify/Company/426793626",

"name": "Fancy Pants Inc."

"customer": {

"id": "gid://shopify/Customer/1073339480",

"firstName": "Avery",

"lastName": "Brown",

"email": "avery.brown@example.com"

}

"userErrors": []

}