Skip to main content
POST
Create a registration to enable tax calculations and automated filing for a jurisdiction. Before calling this endpoint, use the V2 content endpoints to discover available jurisdictions and get the required registration_tax_type_id.

Request body

string
required
The unique identifier (UUID) for the corporation.
string
required
The content ID identifying the jurisdiction and tax type combination. Obtain this from the Available Registrations endpoint.Example: "REG_STATE_CEN_06_RST" (California Retail Sales Tax)
array
required
Array of tax types to register for. Must be valid for the selected registration_tax_type_id.Include the primary tax type and all required related types (where optional: false in the content response). Minimum 1, maximum 100 items.Example: ["RST", "DTT"]
array
Array of filing frequencies. Must exactly match one of the allowed frequency combinations from the content response.Maximum 100 items. This field is optional — if omitted, the registration is created without a filing frequency set.Example: ["QUARTERLY"] or ["QUARTERLY", "ANNUAL_RECONCILIATION"]
string
ISO date (YYYY-MM-DD) when the registration became or becomes effective.
string
Who is creating this registration. Defaults to COMMENDA if not provided.Values: COMMENDA, API, USER
string
Your tax registration ID, permit number, or account number issued by the tax authority.
string
Reference to stored portal credentials (UUID). Can be added later via update.
boolean
Set to true to enable Commenda-managed filing for this registration. When enabled, Commenda handles the filing process on your behalf. Defaults to false.
string
UUID of an existing active domestic registration. Required for Union OSS registrations that have a PREREQUISITE_REGISTRATION condition.The referenced registration must belong to the same corporation and be in an EU country where your business has a qualifying establishment.
string
Content ID of the member country to register through. Required for registrations with a MEMBER_COUNTRY_TO_REGISTER_THROUGH condition (Non-Union OSS, IOSS).Example: "REG_COUNTRY_DE_3001_VAT"

Validation rules

EU establishment rules

For EU trade bloc registrations, additional establishment checks are enforced automatically: Qualifying establishment types: headquarters, branch office, warehouse, factory, retail location, dependent agent.