---
title: "Create Location"
method: POST
path: "/api/v1/locations"
tags: ["Basics"]
---

# Create Location

`POST /api/v1/locations`

Creates a location for a website. `country` is case-insensitive and stored as its canonical label. Any attached `prompt_ids` must allow the location's country.

## Request body

- object
  - `website_id` string, uuid, required
  - `location` string, required — Location name. Trimmed; blank rejected.
  - `country` string, required — Supported country (case-insensitive).
  - `prompt_ids` string[] — Active prompt ids to attach.

## Response `201`

Location created

- object
  - `id` string, uuid, required
  - `location` string, required
  - `country` string, required

## Other responses

- `400` — Bad request - Validation error
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - You don't have access to this website
- `500` — Internal server error

---

[API](https://skmtc.net/athenahq/apis/athenahq-api.md) · [All operations](https://skmtc.net/athenahq/apis/athenahq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/athenahq/athenahq-api/versions/6c5d71622cb9/schema)