---
title: "Create a tax location"
method: POST
path: "/v1/tax/locations"
---

# Create a tax location

`POST /v1/tax/locations`

## Request

- Base URL: `https://api.stripe.com`
- URL: `https://api.stripe.com/v1/tax/locations`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Create a tax location to use in calculating taxes for a service, ticket, or other type of product. The resulting object contains the ID, address, type, and description of the tax location.

## Response `200`

Successful response.

- TaxLocation: Tax locations represent venues for services, tickets, or other product types.
  - `address` Address, required
    - `city` string, nullable: City, district, suburb, town, or village.
    - `country` string, nullable: Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
    - `line1` string, nullable: Address line 1, such as the street, PO Box, or company name.
    - `line2` string, nullable: Address line 2, such as the apartment, suite, unit, or building.
    - `postal_code` string, nullable: ZIP or postal code.
    - `state` string, nullable: State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
  - `description` string, nullable: A descriptive text providing additional context about the tax location. This can include information about the venue, types of events held, services available, or any relevant details for better identification (for example, "A spacious auditorium suitable for large concerts and events.").
  - `id` string, required: Unique identifier for the object.
  - `livemode` boolean, required: If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
  - `object` 'tax.location', required: String representing the object's type. Objects of the same type share the same value.
  - `type` 'performance', required: The type of tax location to be defined. Currently the only option is `performance`.

## Other responses

- `default`: Error response.

---

[API](https://skmtc.dev/stainless-api/apis/stripe-api.md) · [All operations](https://skmtc.dev/stainless-api/apis/stripe-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stainless-api/apis/stripe-api/revisions/7cff4cc46d06?raw)