---
title: "Create Locale"
method: POST
path: "/v2/locales"
tags: ["locale"]
---

# Create Locale

`POST /v2/locales`

Creates a new locale for a site.

## Headers

- `x-api-key` string, required

## Request body

- CreateSiteLocaleV2RequestBodyDto
  - `siteId` string, uuid, required — The site ID to create the locale for.
  - `locale` string, required — Locale of the site locale.
  - `domain` string, uri — The domain URL for domain-based localization. This URL must include the protocol.

## Response `201`

- CreateSiteLocaleV2ResponseBodyDto
  - `object` 'locale', required
  - `id` string, uuid, required — The ID of the created locale.
  - `locale` string, required — We support the subset of locales specified with ISO 3166 that are composed of language and optionally a region.
  - `domain` string, uri, nullable, required — The domain URL for domain-based localization.
  - `pathPrefix` string, nullable, required — Custom URL path prefix. Null means the locale code is used as the default prefix.
  - `isDefault` boolean, required — The flag that indicates whether this locale is the default locale for the site.

## Other responses

- `400`
- `403`
- `404`
- `409`

---

[API](https://skmtc.net/makeswift/apis/rest.md) · [All operations](https://skmtc.net/makeswift/apis/rest/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/makeswift/rest/revisions/2dcb006ac92e/schema)