extensions / Commerce extension
POST
/api/projects/{project_id}/sales/tax-zonesCreate Tax Zone
Creates a tax zone for a project.
GETPOST
Authentication
- Requirement
- Required
- Credential type
- Bearer API key
- Scopes
- Not specified
Permissions
- Requests are scoped to the target project_id. API-key requests must use a key with an active connection to that project.
Headers
| Name | Required | Type | Details |
|---|---|---|---|
Authorization | Yes | Not specified | Description: Bearer credential used to authenticate the request. |
Path Parameters
| Name | Required | Type | Details |
|---|---|---|---|
project_id | Yes | Not specified | Description: Target project identifier. |
Query Parameters
Request Body
Schema: CreateTaxZoneRequest
| Field | Required | Type | Details |
|---|---|---|---|
name | Yes | string | Description: Display name. |
tax_title | No | string | Description: Display title. |
rate_percent | No | number | Description: Numeric value. |
countries | No | JSON | Description: JSON object. |
regions | No | JSON | Description: JSON object. |
cities | No | JSON | Description: JSON object. |
postal_codes | No | JSON | Description: JSON object. |
priority | No | integer | Description: Integer value. |
is_active | No | boolean | Description: Boolean flag. |
Response Body
Example 201 response
json
{
"id": 1,
"project_id": 1,
"name": "Example",
"tax_title": "string",
"rate_percent": "string",
"countries": [],
"regions": [],
"cities": [],
"postal_codes": [],
"priority": "string",
"is_active": "string",
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-01T00:00:00Z"
}Errors
500 internal_server_errorAvailability
- Available in
- v0.1.0
- Available since
- v0.1.0
- Implementation
- Available
- Deprecation
- Not specified
- Rate limits
- Not specified