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

corporation_id
string
required
The unique identifier (UUID) for the corporation.
registration_tax_type_id
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)
tax_types
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"]
frequencies
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"]
effective_start_date
string
ISO date (YYYY-MM-DD) when the registration became or becomes effective.
registered_by
string
Who is creating this registration. Defaults to COMMENDA if not provided.Values: COMMENDA, API, USER
tax_registration_number
string
Your tax registration ID, permit number, or account number issued by the tax authority.
credential_id
string
Reference to stored portal credentials (UUID). Can be added later via update.
managed_filing_enabled
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.
member_state_registration_id
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.
registered_through_registration_tax_type_id
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.