# Create company contacts

Source: https://developer.avalara.com/products/returns/integration-guides/managed-returns/deq7876767308008/

Guide: Avalara Managed Returns API (U.S. and Canada)

# Create company contacts

Manage company contacts for tax-related communications and inquiries.

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.