# create_spot Add a spot (a place the creator has been to). `POST /v1/guides/{productId}/spots` · MCP tool `create_spot` · scope `write` · stable · since 2026-09-17 Coordinates come from the creator (their map link, GPX, or a pin they confirm) or, for a guide the creator asked you to research, from a source you cite in sources; never from memory. Leave lat/lon empty rather than guessing; the readiness check will list what is missing. Titles are place names as locals know them; kicker is the short line above the title (region, type). customValues keys must match list_properties; option values use option ids, not labels. create_spot takes every field update_spot takes (arrival, mapLinks, tripFacts, accessMode, pins, links, status, fees, schedule and the rest), so one call makes a complete spot. For many spots, or re-runs that must not duplicate, use upsert_spots. The response carries warnings (an http link) that did not stop the write. ## Path parameters - `productId` (string, required): Id of the guide (a product of type map). From list_guides or create_guide. ## Body parameters - `title` (string, required): Place name as locals know it, e.g. Oeschinensee or Fushimi Inari-taisha. Cannot be empty. - `accessMode` (string or null, optional): How visitors reach the spot, shown as Accessibility: drive_up, short_walk, hike, multi_day, boat, cable_car, train, flight, tour_only, aerial_only. null clears. Without it the cell shows the easiest required route's grade, or Drive-up only when arrival.byCar describes a drive. One of `drive_up`, `short_walk`, `hike`, `multi_day`, `boat`, `cable_car`, `train`, `flight`, `tour_only`, `aerial_only`. - `areaId` (string, optional): The area (park, island, region) the spot sits in, from set_area; its rules, fees and links show on the spot. Empty string clears. - `arrival` (Arrival or null, optional): How to get there, full replacement, null clears: { byCar?: { directions, parking, walkToSpotMin, walkRoundTrip? (the minutes are there and back), none? (no car access), note? }, byTrainBus?: { route, walkFromStopMin, walkRoundTrip?, none? (no public transport, which reads differently from an empty field), note? }, byBoat?, byAir?: { airports? (IATA or ICAO codes), route?, minutes?, operatorUrl?, luggageKg?, none?, note? }, onFoot?: { route?, minutes?, roundTrip?, none?, note? }, byBike?: { same }, bestTime?, operating?, approaches?: [{ label (Argentine side), country? (AR), legs?: [{ mode: car|bus|train|tram|metro|cable_car|funicular|boat|ferry|plane|helicopter|shuttle|jeep|walk|bike|taxi|other, from?, to?, minutes?, roundTrip?, price?, payment?, note? }], hours?, entry?, note?, lat?, lon? }] (at most 6, for spots with several ways in or chains of legs), rules?: [{ text, kind?: reservation|permit|guide|registration|no_independent_travel|vehicle|other, months? [1-12] (shown only then), appliesTo?: car|all, bookingOpens?, sourceUrl? }] }. Fields of Arrival: https://developers.sceniq.earth/fields/arrival.md - `cardOrientation` (string, optional): portrait or landscape (photo framing in the viewer); a spot without one reads as landscape. One of `portrait`, `landscape`. - `color` (string, optional): Optional pin color hex, e.g. #0071e3. Empty string clears. - `customNotes` (map of strings, optional): One short note per custom property value, keyed by property key, shown next to the value (walls 40 EUR, morning from viewpoint 7). Full replacement ({} clears). - `customPropsEnabled` (boolean, optional): false hides custom properties from buyers; values stay stored. - `customValues` (map of values, optional): Object keyed by property key (list_properties): text for shortLabel and longSection, a number for number, epoch ms for date, one option id for singleSelect, an array of option ids for checkbox (ids, never labels). Every required property needs a value; keys without a live property are kept unchecked. Sent for an existing spot it replaces the stored object; null for a key clears that value. - `events` (array of SpotEvent, optional): Recurring or one-off events worth timing a visit for, full replacement, at most 12: [{ name, when (in words: every night at 19:45 and 20:45), dates? [YYYY-MM-DD] (the apps show the next one), months?, url?, free?, note? }]. Fields of SpotEvent: https://developers.sceniq.earth/fields/spot-event.md - `factsCheckedOn` (string, optional): The day the facts were last checked against their sources (YYYY-MM-DD). Empty string clears. - `features` (array of SpotFeature, optional): Parts of the site with their own rules (a monastery's closing day, a ticketed skyway), full replacement, at most 12: [{ name, note?, hours?, entry?, season?, fees? (as fees), status? (as status), url? }]. Fields of SpotFeature: https://developers.sceniq.earth/fields/spot-feature.md - `fees` (array of Fee, optional): Fees and tickets, full replacement ([] clears), at most 30: [{ label, amount? (major units, e.g. 40 or 12.5; needs currency), currency? (EUR), free?, seeOfficial? (a price left to the official page on purpose), per?: person|vehicle|night|group|entry|day|hour, audience?: all|adult|child|foreign|domestic|resident|student|senior, paidWhere?: online|on_site|in_tour, payment?: cash_only|card_only|cash_or_card, note?, validFrom?, validUntil?, sourceUrl?, checkedOn? }]. Buyers see the amount with an as-of date; readiness flags rows past validUntil or unchecked for a year. Fields of Fee: https://developers.sceniq.earth/fields/fee.md - `food` (FoodNote or null, optional): Why the spot lists no food places, null clears: { status: included (meals come with the lodge or boat) | none_nearby | bring_your_own, note? }. Fields of FoodNote: https://developers.sceniq.earth/fields/food-note.md - `imagesEnabled` (boolean, optional): false hides the photo section from buyers; photos stay stored. - `kicker` (string, optional): Short eyebrow above the title, e.g. Patagonia, Bernese Oberland or Glacier lake. Empty string clears. - `lat` (number, optional): Latitude in decimal degrees (-90 to 90). From the creator's material or a cited source. - `links` (array of GuideLink, optional): Links with a purpose, full replacement ([] clears), at most 12: [{ kind: official|website|tickets|booking|status|timetable|tide|listing|social|authority|app|other, label?, url? (http or https; http is accepted with a warning), value? (a channel that is not a URL, e.g. WeChat mini program: Li River boats), note? }]. Each needs a url or a value. Fields of GuideLink: https://developers.sceniq.earth/fields/guide-link.md - `lon` (number, optional): Longitude in decimal degrees (-180 to 180). - `longDescription` (string, optional): The full write-up in the creator's voice. Empty string clears. - `mapLinks` (array of MapLink, optional): Extra map links [{ label, url }] (https or an allowlisted map link), drawn as map pills. [] clears. For official, ticket or status pages use links instead. Fields of MapLink: https://developers.sceniq.earth/fields/map-link.md - `mapsUrl` (string, optional): The creator's own map link: https on Google Maps, Apple Maps, Swisstopo, OpenStreetMap or SchweizMobil, or a geo: URI. Empty string clears. - `pinLabel` (string, optional): What the main pin marks for a spot that is an area or a line, shown as Pinned: