---
title: "Create a location (402 when plan limit exceeded)"
method: POST
path: "/api/rightos/locations"
tags: ["locations"]
---

# Create a location (402 when plan limit exceeded)

`POST /api/rightos/locations`

## Request

- Base URL: `https://rightos.i-s3.com`
- URL: `https://rightos.i-s3.com/api/rightos/locations`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-rightos-key`

## Request body

- object
  - `name` string, required
  - `address` string
  - `type` 'shop' | 'clinic' | 'ev_charging' | 'event' | 'logistics' | 'pickup' | 'other'
  - `timezone` string

## Response `201`

Created

- object
  - `location` Location
    - `id` string
    - `organizationId` string
    - `name` string
    - `address` string
    - `type` 'shop' | 'clinic' | 'ev_charging' | 'event' | 'logistics' | 'pickup' | 'other'
    - `timezone` string
    - `active` boolean

## Other responses

- `401`: Missing or invalid API key (error: missing_api_key | invalid_api_key)
- `402`: Plan limit exceeded (HTTP 402). Upgrade the plan to continue.

---

[API](https://skmtc.dev/i-s3/apis/rightos-right-api.md) · [All operations](https://skmtc.dev/i-s3/apis/rightos-right-api/llms.txt) · [OpenAPI document](https://skmtc.dev/i-s3/apis/rightos-right-api/revisions/10020536e345?raw)