> 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.

# Field descriptions of Contact

> This reference lists the description of the fields of the Contact object.

This reference lists the description of the fields of the Contact object.

All field names are case sensitive. Check enumerated values in descriptions to confirm capitalization and spacing.

<table>
  <tr>
    <th>
      Name
    </th>

    <th>
      Require to create?
    </th>

    <th>
      Allowed operations
    </th>

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

  <tr>
    <td>
      AccountId
    </td>

    <td>
      optional
    </td>

    <td>
      Create Query Delete Filter
    </td>

    <td>
      The Zuora account ID associated with this contact. This field is not required when you use the subscribe() call. This field is required for all other calls.

      **Type:** zns:ID

      **Character limit:** 32

      **Version notes:** --

      **Values:** a valid account ID
    </td>
  </tr>

  <tr>
    <td>
      Address1
    </td>

    <td>
      optional
    </td>

    <td>
      Create Query Update Delete Filter
    </td>

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

      **Type**: string

      **Character limit**: 255

      **Version notes**: WSDL 12.0 and older require this field for Bill To contacts

      **Values**: a string of 255 characters or fewer
    </td>
  </tr>

  <tr>
    <td>
      Address2
    </td>

    <td>
      optional
    </td>

    <td>
      Create Query Update Delete Filter
    </td>

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

      **Type**: string

      **Character limit**: 255

      **Version notes**: --

      **Values**: a string of 255 characters or fewer
    </td>
  </tr>

  <tr>
    <td>
      City
    </td>

    <td>
      optional
    </td>

    <td>
      Create Query Update Delete Filter
    </td>

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

      **Type**: string

      **Character limit**: 40

      **Version notes**: WSDL 12.0 and older require this field for Bill To contacts

      **Values:** a string of 40 characters or fewer
    </td>
  </tr>

  <tr>
    <td>
      Country
    </td>

    <td>
      conditional
    </td>

    <td>
      Create Query Update Delete Filter
    </td>

    <td>
      The country of the contact's address. If using Z-Tax , be aware that it requires a country in the sold-to contact to calculate tax, and that a bill-to contact may be used if no sold-to contact is provided.

      **Type**: string

      **Character limit**: 32

      **Version notes**: WSDL 12.0 and older require this field for bill-to contacts

      **Values**: a valid country name or abbreviation
    </td>
  </tr>

  <tr>
    <td>
      County
    </td>

    <td>
      optional
    </td>

    <td>
      Create Query Update Delete Filter
    </td>

    <td>
      The country. May optionally be used by Z-Tax to calculate county tax.

      **Type**: string

      **Character limit**: 32

      **Version notes**: WSDL 12.0 and older require this field for Bill To contacts

      **Values**: a string of 32 characters or fewer
    </td>
  </tr>

  <tr>
    <td>
      CreatedById
    </td>

    <td>
      optional
    </td>

    <td>
      Query Filter
    </td>

    <td>
      The ID of the Zuora user who created the contact.

      **Type**: zns:ID

      **Character limit**: 32

      **Version notes**: WSDL 20.0+

      **Values**: automatically generated
    </td>
  </tr>

  <tr>
    <td>
      CreatedDate
    </td>

    <td>
      optional
    </td>

    <td>
      Query Filter
    </td>

    <td>
      The date when the contact was created.

      **Type**: dateTime

      **Character limit**: 29

      **Version notes**: WSDL 20.0+

      **Values**: automatically generated
    </td>
  </tr>

  <tr>
    <td>
      Description
    </td>

    <td>
      optional
    </td>

    <td>
      Create Query Update Delete Filter
    </td>

    <td>
      A description for the contact.

      **Type**: string

      **Character limit**: 100

      **Version notes**: --

      **Values**: a string of 100 characters or fewer
    </td>
  </tr>

  <tr>
    <td>
      Fax
    </td>

    <td>
      optional
    </td>

    <td>
      Create Query Update Delete Filter
    </td>

    <td>
      The contact's fax number.

      **Type**: string

      **Character limit**: 40

      **Version notes**: --

      **Values**: a string of 40 characters or fewer
    </td>
  </tr>

  <tr>
    <td>
      FirstName
    </td>

    <td>
      required
    </td>

    <td>
      Create Query Update Delete Filter
    </td>

    <td>
      The contact's first name.

      **Type**: string

      **Character limit**: 100

      **Version notes**: --

      **Values**: a string of the contact's first name
    </td>
  </tr>

  <tr>
    <td>
      HomePhone
    </td>

    <td>
      optional
    </td>

    <td>
      Create Query Update Delete Filter
    </td>

    <td>
      The contact's home phone number.

      **Type**: string

      **Character limit**: 40

      **Version notes**: --

      **Values**: a string of 40 characters or fewer
    </td>
  </tr>

  <tr>
    <td>
      Id
    </td>

    <td>
      required
    </td>

    <td>
      Query Filter
    </td>

    <td>
      The ID of this object. Upon creation of this object, this field becomes `ContactId` .

      **Type**: zns:ID

      **Character limit**: 32

      **Version notes**: --

      **Values**: automatically generated
    </td>
  </tr>

  <tr>
    <td>
      LastName
    </td>

    <td>
      required
    </td>

    <td>
      Create Query Update Delete Filter
    </td>

    <td>
      The contact's last name.

      **Type**: string

      **Character limit**: 100

      **Version notes**: --

      **Values**: a string of 100 characters or fewer
    </td>
  </tr>

  <tr>
    <td>
      MobilePhone
    </td>

    <td>
      optional
    </td>

    <td>
      Create Query Update Delete Filter
    </td>

    <td>
      The contact's mobile phone number.

      **Type**: string

      **Character limit**: 40

      **Version notes**: --

      **Values**: a string of 40 characters or fewer
    </td>
  </tr>

  <tr>
    <td>
      NickName
    </td>

    <td>
      optional
    </td>

    <td>
      Create Query Update Delete Filter
    </td>

    <td>
      A nickname for the contact.

      **Type**: string

      **Character limit**: 100

      **Version notes**: --

      **Values**: a string of 100 characters or fewer
    </td>
  </tr>

  <tr>
    <td>
      OtherPhone
    </td>

    <td>
      optional
    </td>

    <td>
      Create Query Update Delete Filter
    </td>

    <td>
      An additional phone number for the contact.

      **Type**: string

      **Character limit**: 40

      **Version notes**: --

      **Values**: a string of 40 characters or fewer
    </td>
  </tr>

  <tr>
    <td>
      OtherPhoneType
    </td>

    <td>
      optional
    </td>

    <td>
      Create Query Update Delete Filter
    </td>

    <td>
      The type of the `OtherPhone` .

      **Type**: string

      **Character limit**: 20

      **Version notes**: --

      **Values**: `Work` , `Mobile` , `Home` , `Other`
    </td>
  </tr>

  <tr>
    <td>
      PersonalEmail
    </td>

    <td>
      optional
    </td>

    <td>
      Create Query Update Delete Filter
    </td>

    <td>
      The contact's personal email address.

      **Type**: string

      **Character limit**: 80

      **Version notes**: --

      **Values**: a string of 80 characters or fewer
    </td>
  </tr>

  <tr>
    <td>
      PostalCode
    </td>

    <td>
      optional
    </td>

    <td>
      Create Query Update Delete Filter
    </td>

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

      **Type:** string

      **Character limit:** 20

      **Version notes:** WSDL 12.0 and older require this field for Bill To contacts

      **Values:** a string of 20 characters or fewer
    </td>
  </tr>

  <tr>
    <td>
      State
    </td>

    <td>
      optional
    </td>

    <td>
      Create Query Update Delete Filter
    </td>

    <td>
      The state or province of the contact's address. If using Z-Tax , be aware that if the country is USA or Canada, Z-Tax requires a state or province in the sold-to contact to calculate tax, and that a bill-to contact may be used if no sold-to contact is provided.

      **Type:** string

      **Character limit:** 40

      **Version notes:** WSDL 12.0 and older require this field for Bill To contacts

      **Values:** a valid state name or abbreviation
    </td>
  </tr>

  <tr>
    <td>
      TaxRegion
    </td>

    <td>
      optional
    </td>

    <td>
      Create Query Update Delete Filter
    </td>

    <td>
      If using Z-Tax , a region string as optionally defined in your tax rules. Not required.

      **Type**: string

      **Character limit**: 32

      **Version notes**: Z-Tax

      **Values**: a string defined in your Z-Tax tax rules
    </td>
  </tr>

  <tr>
    <td>
      UpdatedById
    </td>

    <td>
      optional
    </td>

    <td>
      Query Filter
    </td>

    <td>
      The ID of the user who lasted updated the contact.

      **Type**: zns:ID

      **Character limit**: 32

      **Version notes**: WSDL 20.0+

      **Values**: automatically generated
    </td>
  </tr>

  <tr>
    <td>
      UpdatedDate
    </td>

    <td>
      optional
    </td>

    <td>
      Query Filter
    </td>

    <td>
      The date when the contact was last updated.

      **Type**: dateTime

      **Character limit**: 29

      **Version notes**: WSDL 20.0+

      **Values**: automatically generated
    </td>
  </tr>

  <tr>
    <td>
      WorkEmail
    </td>

    <td>
      optional
    </td>

    <td>
      Create Query Update Delete Filter
    </td>

    <td>
      The contact's business email address.

      **Type**: string

      **Character limit**: 80

      **Version notes**: WSDL 12.0 and older require this field for Bill To contacts

      **Values**: a string of 80 characters or fewer
    </td>
  </tr>

  <tr>
    <td>
      WorkPhone
    </td>

    <td>
      optional
    </td>

    <td>
      Create Query Update Delete Filter
    </td>

    <td>
      The contact's business phone number.

      **Type**: string

      **Character limit**: 40

      **Version** **notes**: --

      **Values**: a string of 40 characters or fewer
    </td>
  </tr>
</table>