POST

Create Tax Region


Creates a tax region.

A tax region requires a tax calculator appId. Call List Tax Calculators to retrieve the available calculators for a site, and never hardcode the appId. Calculator app IDs are installation-scoped and can differ between sites.

Set subdivision to a state, province, or prefecture using its ISO 3166-2 code without the country prefix (for example, NY), or leave it empty (or *) to create a country-level region. Subdivisions are supported only for these countries: AU, BR, CA, FR, DE, IN, IT, MX, NL, PT, ES, AE, GB, and US. For any other country, create the region at the country level; a subdivision-level region for an unsupported country may be rejected with SUBDIVISIONS_NOT_SUPPORTED_FOR_COUNTRY.

Tax regions can't be created for embargoed countries (Cuba, Iran, North Korea, and Syria).

Authentication

This method may require higher-level permissions than the caller has, based on their identity and roles and permissions. In these cases, you can ensure the method is called with the required level of authorization by using one of the following:

Permissions
Manage Orders
Learn more about app permissions.
Method Declaration
Copy
Errors
400Invalid Argument

There are 2 errors with this status code.

404Not Found

There is 1 error with this status code.

409Already Exists

There is 1 error with this status code.

428Failed Precondition

There is 1 error with this status code.

This method may also return standard errors. Learn more about standard Wix errors.

Event TriggersThis method triggers the following events:
Did this help?