REST API CRUD Support for Tax Control Account Record (taxAcct)

What changed

The tax control account record is available through the SuiteTalk REST web services. This record stores the GL account to which computed indirect-tax amounts (sales tax, VAT) are posted. The REST record ID is taxAcct.

Endpoint

/services/rest/record/v1/taxacct

Supported actions

• POST — Create a new tax control account
• GET /taxacct/{{taxacctId}} — Retrieve by internal ID
• PATCH /taxacct/{{taxacctId}} — Update fields (partial payload)
• DELETE /taxacct/{{taxacctId}} — Delete by internal ID

Required fields on POST

• name — Display name
• nexus — Internal ID of the nexus (string)
• taxAcctType — Object with id (e.g., "sale") and refName

Optional fields include description and isInactive.

Prerequisites

The Legacy Tax feature must be enabled. This record is not part of SuiteTax; it applies to accounts still on Legacy Tax.

Cascade delete behavior

If the nexus referenced by a tax control account record is deleted, the tax control account record is also deleted. Integrations that store taxacctId references should account for this — a previously valid ID may 404 after a nexus cleanup.

Example: create a tax control account

POST /services/rest/record/v1/taxacct

{
  "description": "TaxAccount Ghana desc",
  "isInactive": false,
  "name": "TaxAccount Ghana name",
  "nexus": "10",
  "taxAcctType": {
    "id": "sale",
    "refName": "sale"
  }
}

What to do

1. Confirm Legacy Tax is enabled at Setup > Company > Enable Features > Tax. This endpoint is not available under SuiteTax.
2. Use the REST API Browser to inspect the full field list and types for taxAcct — the source documentation defers detailed schema to the browser.
3. If your integration creates or manages nexus records, add defensive handling for the cascade-delete behavior: a nexus deletion will silently remove any linked tax control accounts.
4. Note the UI path for manual verification: Setup > Accounting > Taxes > Tax Control Accounts (Administrator role required).

Note: The source documentation does not specify which NetSuite release introduced REST support for this record. Check the REST API Browser in your target account to confirm availability before building against it.