# createJurisdiction (https://developer.godaddy.com/en/docs/references/rest/taxes/jurisdiction/mutations/createJurisdiction)

***

title: createJurisdiction
description: "Create a new jurisdiction."
full: true
----------

mutation

Requires `commerce.tax:create`.

Create a new jurisdiction.

`metafields` is optional — omit it. If you send it, the array must be nonempty; `[]` is rejected. Prefer `type: "string"` (lowercase).

## Required headers

| Header       | Required | Description                                                                                                                     |
| ------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `x-store-id` | Yes      | ID of the store the operation targets. Omitting it returns HTTP 200 with a GraphQL error: `extensions.code: "UNAUTHENTICATED"`. |

Go to [Authentication](https://developer.godaddy.com/docs/api-users/auth) for credential setup.

## Arguments

* `input` `MutationCreateJurisdictionInput!` **required**
  * `countryCode` `String!` **required** — The [two-character ISO 3166-1 code](https://en.wikipedia.org/wiki/ISO_3166-1) that identifies the country or region.
  * `adminArea1` `String` **optional** — The highest level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision; formatted for postal delivery.
  * `adminArea2` `String` **optional** — The city, town, or village. Smaller than `adminArea1`.
  * `adminArea3` `String` **optional** — The sub-locality, suburb, neighborhood, or district. Smaller than `adminArea2`.
  * `adminArea4` `String` **optional** — The neighborhood, ward, or district. Smaller than `adminArea3`.
  * `metafields` `[CreateMetafieldInput!]` **optional** — Any metafields to be created and assigned to the new jurisdiction.
    * `key` `String!` **required**
    * `namespace` `String!` **required**
    * `type` `String!` **required** — Metafield value type. Prefer lowercase values such as `string`. Catalog rejects uppercase `STRING`; Tax currently accepts both.
    * `value` `String!` **required**
  * `postalCode` `String` **optional** — The postal code, which is the zip code or equivalent.

## Possible returns

* `Jurisdiction` `Jurisdiction` — A geographic area or "zone" in which a rate or set of rates applies.

- `adminArea1` `String` **nullable** — The highest level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision.
- `adminArea2` `String` **nullable** — The city, town, or village.
- `adminArea3` `String` **nullable** — The sub-locality, suburb, neighborhood, or district.
- `adminArea4` `String` **nullable** — The neighborhood, ward, or district.
- `countryCode` `String!` **non-null** — The country code of the address.
- `createdAt` `DateTime!` **non-null** — The data & time at which the jurisdiction was created.
- `id` `ID!` **non-null** — The globally-unique ID.
- `metafields` `JurisdictionMetafieldsConnection` **nullable**
- `postalCode` `String` **nullable** — The postal code of the address.
- `rates` `JurisdictionRatesConnection` **nullable** — The rates associated with the jurisdiction.
- `updatedAt` `DateTime!` **non-null** — The data & time at which the jurisdiction was last updated.