---
title: "Create Place"
method: POST
path: "/api/v1/places"
tags: ["places"]
---

# Create Place

`POST /api/v1/places`

## Request

- Base URL: `https://yondry.app` (the document declares no server; this is the origin it was published from)
- URL: `https://yondry.app/api/v1/places`
- Auth: HTTP bearer

## Request body

- PlaceCreate: Fields for creating a place manually via POST /places. place_type and source_type are recommended but optional so that existing mobile API calls (which omit them) continue to work without changes.
  - `name` string, required
  - `place_type` 'park' | 'playground' | 'museum' | 'cafe' | 'restaurant' | 'bar' | 'activity' | 'shopping' | 'other'
  - `source_type` 'manual' | 'google_import' | 'url_import' | 'screenshot' | 'social_save'
  - `address` string, nullable
  - `lat` number, nullable
  - `lon` number, nullable
  - `city` string, nullable
  - `country_code` string, nullable
  - `google_place_id` string, nullable
  - `user_notes` string, nullable
  - `user_tags` string[]
  - `is_favourite` boolean
  - `source_url` string, nullable
  - `category` string, nullable
  - `indoor_outdoor` 'indoor' | 'outdoor' | 'both', nullable
  - `budget_level` 'free' | 'low' | 'medium' | 'high', nullable
  - `kid_min_age` integer, nullable
  - `kid_max_age` integer, nullable
  - `always_open` boolean
  - `opening_time` string, nullable
  - `closing_time` string, nullable
  - `tags` string[]
  - `notes` string, nullable

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/yondry/apis/yondry-api.md) · [All operations](https://skmtc.dev/yondry/apis/yondry-api/llms.txt) · [OpenAPI document](https://skmtc.dev/yondry/apis/yondry-api/revisions/d2c213cea95b?raw)