> This page is for Docs.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# Contacts import fields

> Use this reference document to view all the fields associated with the contacts data dictionary.

Use this reference document to view all the fields associated with the contacts data dictionary.

> **Note**
>
> Fields with an asterisk mark indicate mandatory fields.

<table>
  <tr>
    <th>
      Object
    </th>

    <th>
      Field Name
    </th>

    <th>
      Value
    </th>

    <th>
      Required to create
    </th>

    <th>
      Description
    </th>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      accountId
    </td>

    <td>
      String
    </td>

    <td>
      Required to Create
    </td>

    <td>
      The ID of the account associated with the contact.

      > **Note**
      >
      > When creating a contact, you must specify accountNumber, accountId, or both in the request body. If both fields are specified, they must correspond to the same account.
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      accountNumber
    </td>

    <td>
      String
    </td>

    <td>
      Optional
    </td>

    <td>
      The number of the customer account associated with the contact.

      > **Note**
      >
      > When creating a contact, you must specify accountNumber, accountId, or both in the request body. If both fields are specified, they must correspond to the same account.
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      address1
    </td>

    <td>
      String \<= 255 characters
    </td>

    <td>
      Optional
    </td>

    <td>
      The first line of the contact's address, which is often a street address or business name.
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      address2
    </td>

    <td>
      String \<= 255 characters
    </td>

    <td>
      Optional
    </td>

    <td>
      The second line of the contact's address.
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      city
    </td>

    <td>
      String \<= 40 characters
    </td>

    <td>
      Optional
    </td>

    <td>
      The city of the contact's address.
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      contactDescription
    </td>

    <td>
      String \<= 100 characters
    </td>

    <td>
      Optional
    </td>

    <td>
      A description for the contact.
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      country
    </td>

    <td>
      String \<= 64 characters
    </td>

    <td>
      Optional
    </td>

    <td>
      The country of the contact's address.
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      county
    </td>

    <td>
      String \<= 32 characters
    </td>

    <td>
      Optional
    </td>

    <td>
      The county. May optionally be used by Zuora Tax to calculate county tax.
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      fax
    </td>

    <td>
      String \<= 40 characters
    </td>

    <td>
      Optional
    </td>

    <td>
      The contact's fax number.
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      firstName
    </td>

    <td>
      String \<= 100 characters
    </td>

    <td>
      Required to Create
    </td>

    <td>
      The contact's first name.
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      homePhone
    </td>

    <td>
      String \<= 40 characters
    </td>

    <td>
      Optional
    </td>

    <td>
      The contact's home phone number.
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      lastName
    </td>

    <td>
      String \<= 100 characters
    </td>

    <td>
      Required to Create
    </td>

    <td>
      The contact's last name.
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      mobilePhone
    </td>

    <td>
      String \<= 100 characters
    </td>

    <td>
      Optional
    </td>

    <td>
      The mobile phone number of the contact.
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      nickname
    </td>

    <td>
      String \<= 100 characters
    </td>

    <td>
      Optional
    </td>

    <td>
      A nickname for the contact.
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      otherPhone
    </td>

    <td>
      String \<= 40 characters
    </td>

    <td>
      Optional
    </td>

    <td>
      An additional phone number for the contact.
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      otherPhoneType
    </td>

    <td>
      String
    </td>

    <td>
      Optional
    </td>

    <td>
      The type of the additional phone number. Enum: "Work" "Mobile" "Home" "Other"
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      personalEmail
    </td>

    <td>
      String \<email> \<= 80 characters
    </td>

    <td>
      Optional
    </td>

    <td>
      The contact's personal email address.
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      state
    </td>

    <td>
      String \<= 40 characters
    </td>

    <td>
      Optional
    </td>

    <td>
      The state or province of the contact's address.
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      taxRegion
    </td>

    <td>
      String \<= 32 characters
    </td>

    <td>
      Optional
    </td>

    <td>
      If using Zuora Tax, a region String as optionally defined in your tax rules. Not required.
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      workEmail
    </td>

    <td>
      String \<= 74 characters
    </td>

    <td>
      Optional
    </td>

    <td>
      The contact's business email address.
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      workPhone
    </td>

    <td>
      String \<= 40 characters
    </td>

    <td>
      Optional
    </td>

    <td>
      The contact's business phone number.
    </td>
  </tr>

  <tr>
    <td>
      Contact
    </td>

    <td>
      zipCode
    </td>

    <td>
      String \<= 20 characters
    </td>

    <td>
      Optional
    </td>

    <td>
      The zip code for the contact's address.
    </td>
  </tr>
</table>