---
title: "Create a location"
method: POST
path: "/v1/location"
tags: ["Locations"]
---

# Create a location

`POST /v1/location`

## Request body

- CreateLocationRequest
  - `address_1` string, required
  - `address_2` string, nullable
  - `city` string, required
  - `state` string, required
  - `zip_code` string, required
  - `lat` number, nullable
  - `lon` number, nullable
  - `reference_key` string, nullable
  - `market_id` string, nullable — ID of the market this location belongs to. Must reference an existing market in your organization. Cannot be combined with market_name.
  - `market_name` string, nullable — Deprecated: prefer market_id. Looks up an existing market by name within your organization. Cannot be combined with market_id.
  - `custom_fields` object, nullable

## Response `200`

OK

- LocationResponse
  - `location` LocationExternalSchema, required
    - `id` string, required
    - `address_1` string, required
    - `address_2` string, nullable, required
    - `city` string, required
    - `state` string, required
    - `zip_code` string, required
    - `lat` number, nullable, required
    - `lon` number, nullable, required
    - `reference_key` string, nullable, required — Optional unique identifier for this location in your system.
    - `market_id` string, nullable, required — ID of the market this location belongs to.
    - `market_name` string, nullable, required — Deprecated: prefer market_id. Name of the geographic market this location belongs to.
    - `custom_fields` object, nullable, required — Arbitrary key-value metadata. Supports partial updates.

---

[API](https://skmtc.net/navigateai/apis/navigateai-api.md) · [All operations](https://skmtc.net/navigateai/apis/navigateai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/navigateai/navigateai-api/revisions/5fb236d03a88/schema)