Create company contacts

Create one or more contacts for a specific company. This action adds new contact persons associated with tax-related communications and inquiries.

Common use cases

The following use cases describe common scenarios in which you need to create a contact:

Add primary contact persons during company onboarding to ensure accurate setup and communication.
Create contacts for tax representatives or authorized signatories who act on behalf of the company.
Set up multiple points of contact for different tax jurisdictions to support localized compliance needs.
Add billing or administrative contacts to manage tax filing, invoicing, and operational communications.

To create a company contact, use the createContacts mutation.

View request

mutation CreateContacts {
  createContacts(
    input: {
      companyId: 12345
      contacts: [
        {
          firstName: "John"
          lastName: "Smith"
          title: "Tax Manager"
          email: "john.smith@company.com"
          phone: "555-123-4567"
          mobile: "555-987-6543"
          line1: "123 Main Street"
          line2: "Suite 100"
          city: "Seattle"
          region: "WA"
          postalCode: "98101"
          country: "US"
          contactCode: "TAX-MGR-001"
        },
        {
          firstName: "Emily"
          lastName: "Johnson"
          title: "Finance Director"
          email: "emily.johnson@company.com"
          phone: "555-222-3344"
          mobile: "555-666-7788"
          line1: "456 Market Avenue"
          line2: "Floor 5"
          city: "San Francisco"
          region: "CA"
          postalCode: "94105"
          country: "US"
          contactCode: "FIN-DIR-002"
        }
      ]
    }
  ) {
    id
    companyId
    firstName
    lastName
    title
    email
    phone
    mobile
    contactCode
    line1
    line2
    city
    region
    postalCode
    country
  }
}

View response

{
  "data": {
    "createContacts": [
      {
        "id": 789,
        "companyId": 12345,
        "firstName": "John",
        "lastName": "Smith",
        "title": "Tax Manager",
        "email": "john.smith@company.com",
        "phone": "555-123-4567",
        "mobile": "555-987-6543",
        "contactCode": "TAX-MGR-001",
        "line1": "123 Main Street",
        "line2": "Suite 100",
        "city": "Seattle",
        "region": "WA",
        "postalCode": "98101",
        "country": "US"
      },
      {
        "id": 790,
        "companyId": 12345,
        "firstName": "Emily",
        "lastName": "Johnson",
        "title": "Finance Director",
        "email": "emily.johnson@company.com",
        "phone": "555-222-3344",
        "mobile": "555-666-7788",
        "contactCode": "FIN-DIR-002",
        "line1": "456 Market Avenue",
        "line2": "Floor 5",
        "city": "San Francisco",
        "region": "CA",
        "postalCode": "94105",
        "country": "US"
      }
    ]
  }
}

The contact is created and associated with the specified company.