Add a location
create_locationAdd one location, or many in a single call. A plain address is geocoded automatically, so lat and lng are only needed to override the result. Pass locations with an array to add a batch: adding ten showrooms is one call, not ten, and the reply says exactly which ones landed. Counts against the plan's location allowance.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "create_location"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude. Supplying lat and lng skips geocoding. | |
| lng | No | Longitude. | |
| city | No | ||
| name | No | Business or store name. | |
| No | |||
| hours | No | Opening hours keyed by ISO weekday, 1 = Monday. Each value is ONE {open, close} in 24h HH:MM, or null for closed — not a list, and a list is rejected. Example: {"1": {"open": "09:00", "close": "17:00"}, "7": null}. REPLACES the whole week: any day left out is cleared. To change one day without restating the rest, use hoursPatch. | |
| phone | No | ||
| state | No | ||
| address | No | Full address as a person would write it. Geocoded automatically unless lat and lng are supplied. | |
| website | No | ||
| imageUrl | No | ||
| priority | No | Higher sorts first when there is no visitor position. | |
| timezone | No | IANA timezone, for example America/Chicago. | |
| locations | No | Several locations to add in one call (at most 50). Use this instead of the top-level fields when adding more than one; each entry takes the same fields. | |
| hoursPatch | No | Change only the days named, leaving every other day exactly as it is. Same shape as hours but partial: {"7": {"open": "10:00", "close": "16:00"}} changes Sunday alone, and {"7": null} closes it. Use this to edit hours; it cannot silently revert a day you did not mention. Ignored if hours is also sent. | |
| postalCode | No | ||
| visibility | No | hidden keeps the location in the account but off the public locator. | |
| countryCode | No | Two-letter ISO country code. | |
| description | No | ||
| markerColor | No | Hex colour for this location's map marker. | |
| addressLine1 | No | Street line, when the address is structured. | |
| customFields | No | Extra fields, keyed by the label shown to visitors. The value is either a plain string, or an object {value, color, icon, style} where `value` is the URL or text. There is no `label` or `url` key: the label is the key, and the URL goes in `value`. Example: {"Book a table": {"value": "https://example.com/book", "color": "#C2540E"}}. Never use this for tags or categories; use the categories field instead. | |
| locationType | No | point is a physical address, service_area covers a radius, online is a stockist with no address. | |
| onlineRegions | No | For an online location: two-letter country codes it ships to or serves, e.g. ["us", "ca"]. Empty means every visitor sees it. | |
| serviceRadiusKm | No | Radius in km, for a service_area location. | |
| serviceAreaCircleVisible | No | For a service_area location: whether to draw its coverage circle. Null (the default) follows the locator's serviceAreaCircleVisible setting. False draws the pin without the circle. |