Registrations V2
Create Registration
Create a new V2 tax registration for a corporation
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
The unique identifier (UUID) for the corporation.
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 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 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"]ISO date (YYYY-MM-DD) when the registration became or becomes effective.
Who is creating this registration. Defaults to
COMMENDA if not provided.Values: COMMENDA, API, USERYour tax registration ID, permit number, or account number issued by the tax authority.
Reference to stored portal credentials (UUID). Can be added later via update.
Set to
true to enable Commenda-managed filing for this registration. When enabled, Commenda handles the filing process on your behalf. Defaults to false.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.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.
Related
- V2 Registration Content — Discover jurisdictions and get content IDs
- Update Registration V2 — Add credentials or update fields
- Registration Conditions — Check conditions before creating
- Tax Registrations V2 Overview — Full workflow