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

# Legacy accounts update fields

> Use this reference to view all the fields associated with the legacy accounts data dictionary.

Use this reference to view all the fields associated with the legacy accounts data dictionary.

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

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

    <th>
      Description
    </th>

    <th>
      Value
    </th>
  </tr>

  <tr>
    <td>
      Id \*
    </td>

    <td>
      account ID
    </td>

    <td>
      string
    </td>
  </tr>

  <tr>
    <td>
      Account Name
    </td>

    <td>
      Specify the customer account name.
    </td>

    <td>
      string \<= 255 characters
    </td>
  </tr>

  <tr>
    <td>
      Account Notes
    </td>

    <td>
      A string of up to 65,535 characters.
    </td>

    <td>
      string
    </td>
  </tr>

  <tr>
    <td>
      Account Number
    </td>

    <td>
      A unique identifier assigned to the account.
    </td>

    <td>
      string
    </td>
  </tr>

  <tr>
    <td>
      Additional Email Addresses
    </td>

    <td>
      A list of additional email addresses to receive email notifications. Use commas to separate email addresses.
    </td>

    <td>
      array of strings
    </td>
  </tr>

  <tr>
    <td>
      Allow Invoice Edit
    </td>

    <td>
      Indicates whether the invoice can be edited after it is created.

      Character limit: 5

      Default: false
    </td>

    <td>
      boolean
    </td>
  </tr>

  <tr>
    <td>
      Auto Pay
    </td>

    <td>
      Indicates whether future payments are automatically billed upon reaching their due date.
    </td>

    <td>
      boolean
    </td>
  </tr>

  <tr>
    <td>
      Batch
    </td>

    <td>
      The alias name given to a batch. A string of 50 characters or less.

      > **Note**
      >
      > By default, you have 50 configurable account batches.
    </td>

    <td>
      string
    </td>
  </tr>

  <tr>
    <td>
      Bcd Setting Option
    </td>

    <td>
      Billing cycle day setting option.
    </td>

    <td>
      string
    </td>
  </tr>

  <tr>
    <td>
      Bill Cycle Day
    </td>

    <td>
      Sets the bill cycle day (BCD) for the charge. The BCD determines which day of the month the customer is billed. Values: Any activated system-defined bill cycle day （1-31).
    </td>

    <td>
      integer \<= 2 characters
    </td>
  </tr>

  <tr>
    <td>
      Bill To Id
    </td>

    <td>
      A valid contact Id of the person to be billed for the account.
    </td>

    <td>
      string \<= 32 characters
    </td>
  </tr>

  <tr>
    <td>
      Communication Profile Id
    </td>

    <td>
      The ID of the communication profile that this account is linked to.
    </td>

    <td>
      string
    </td>
  </tr>

  <tr>
    <td>
      CRM Account Id
    </td>

    <td>
      CRM account ID for the account, up to 100 characters.
    </td>

    <td>
      string
    </td>
  </tr>

  <tr>
    <td>
      Currency
    </td>

    <td>
      A currency as defined in Billing Settings.

      You can update this value only when the account is in Draft status. Once the account is activated, you cannot update this value.
    </td>

    <td>
      string \<= 100 characters
    </td>
  </tr>

  <tr>
    <td>
      Customer Service Rep Name
    </td>

    <td>
      Name of the account's customer service representative, if applicable.
    </td>

    <td>
      string \<= 50 characters
    </td>
  </tr>

  <tr>
    <td>
      Default Payment Method Id
    </td>

    <td>
      Id of the default payment method for the account.

      Values: a valid Id for an existing payment method.
    </td>

    <td>
      string \<= 64 characters
    </td>
  </tr>

  <tr>
    <td>
      Invoice Delivery Prefs Email
    </td>

    <td>
      Whether the customer wants to receive invoices through email. The default value is false.
    </td>

    <td>
      boolean
    </td>
  </tr>

  <tr>
    <td>
      Invoice Delivery Prefs Print
    </td>

    <td>
      Whether the customer wants to receive invoices through email. The default value is false.
    </td>

    <td>
      boolean
    </td>
  </tr>

  <tr>
    <td>
      Invoice Template Id
    </td>

    <td>
      Invoice template ID, configured in Billing Settings in the Zuora UI.
    </td>

    <td>
      string
    </td>
  </tr>

  <tr>
    <td>
      Parent Id
    </td>

    <td>
      Identifier of the parent customer account for this Account object. Use this field if you have Customer Hierarchy enabled.
    </td>

    <td>
      string \<= 32 characters
    </td>
  </tr>

  <tr>
    <td>
      Payment Gateway Name
    </td>

    <td>
      The name of the payment gateway instance. If null or left unassigned, the Account will use the Default Gateway.
    </td>

    <td>
      string
    </td>
  </tr>

  <tr>
    <td>
      Payment Method Cascading Consent
    </td>

    <td>
      Indicates whether you have collected consent from your customer to use the Cascading Payment Method feature.
    </td>

    <td>
      boolean
    </td>
  </tr>

  <tr>
    <td>
      Payment Term
    </td>

    <td>
      Indicates when the customer pays for subscriptions,a valid, active payment term defined in the web-based UI administrative settings.
    </td>

    <td>
      string
    </td>
  </tr>

  <tr>
    <td>
      Purchase Order Number
    </td>

    <td>
      The purchase order number provided by your customer for services, products, or both purchased.
    </td>

    <td>
      string
    </td>
  </tr>

  <tr>
    <td>
      Sales Rep Name
    </td>

    <td>
      The name of the sales representative associated with this account, if applicable. Maximum of 50 characters.
    </td>

    <td>
      string
    </td>
  </tr>

  <tr>
    <td>
      Sequence Set Id
    </td>

    <td>
      The Id of the billing document sequence set to assign to the customer account.
    </td>

    <td>
      string or null
    </td>
  </tr>

  <tr>
    <td>
      Sold To Id
    </td>

    <td>
      A valid contact ID of the person who purchased the subscription associated with the account.
    </td>

    <td>
      string \<= 32 characters
    </td>
  </tr>

  <tr>
    <td>
      Status
    </td>

    <td>
      Status of the account in the system.

      If you're using subscribe(), leave this field as `null`.

      If you're using create(), specify one of the following statuses:

      * `Draft`
      * `Active`
      * `Canceled`
    </td>

    <td>
      string
    </td>
  </tr>

  <tr>
    <td>
      Tax Company Code
    </td>

    <td>
      Unique code that identifies a company account in Avalara. Use this field to calculate taxes based on origin and sold-to addresses in Avalara.
    </td>

    <td>
      string \<=50 characters
    </td>
  </tr>

  <tr>
    <td>
      Tax Exempt Certificate Id
    </td>

    <td>
      Id of the customer's tax exemption certificate.
    </td>

    <td>
      string
    </td>
  </tr>

  <tr>
    <td>
      Tax Exempt Certificate Type
    </td>

    <td>
      Type of tax exemption certificate that the customer holds.
    </td>

    <td>
      string
    </td>
  </tr>

  <tr>
    <td>
      Tax Exempt Description
    </td>

    <td>
      Description of the tax exemption certificate that the customer holds.
    </td>

    <td>
      string
    </td>
  </tr>

  <tr>
    <td>
      Tax Exempt Effective Date
    </td>

    <td>
      Date when the customer tax exemption starts.
    </td>

    <td>
      string \<date>
    </td>
  </tr>

  <tr>
    <td>
      Tax Exempt Expiration Date
    </td>

    <td>
      Date when the customer tax exemption expires.
    </td>

    <td>
      string \<date>
    </td>
  </tr>

  <tr>
    <td>
      Tax Exempt Issuing Jurisdiction
    </td>

    <td>
      Jurisdiction in which the customer tax exemption certificate was issued.
    </td>

    <td>
      string
    </td>
  </tr>

  <tr>
    <td>
      Tax Exempt Status
    </td>

    <td>
      Status of the account tax exemption.

      This field is required when using Z-Tax and is not available if Z-Tax is not enabled.

      Values:

      * **Yes**
      * **No (default)**
      * **Pending Verification**
    </td>

    <td>
      string
    </td>
  </tr>

  <tr>
    <td>
      VAT Id
    </td>

    <td>
      EU Value Added Tax ID.
    </td>

    <td>
      string \<= 25
    </td>
  </tr>
</table>