Spaces

Create a space

Creates a new business listing / space. Requires latitude, longitude, and a message. Optionally link it to your organization via organizationId.

post/maps-service/spaces

Request

  • Base URL
    https://api.therr.com/v1
  • Auth
    API key in header x-api-key

Request body

fromUserIdstring uuid required

Your user ID

messagestring required

Space description / about text

notificationMsgstring

Short notification message (displayed in feeds)

latitudenumber required

Latitude of the space location

longitudenumber required

Longitude of the space location

radiusnumber

Radius in meters (default: 10). Required if polygonCoords not provided.

categorystring

Business category (e.g., 'restaurant', 'bar', 'shop')

isPublicboolean

Whether the space is publicly visible

isDraftboolean

Whether this is a draft listing

organizationIdstring uuid

Link space to an organization. You must have admin or manager access to the organization.

addressReadablestring

Human-readable address

addressStreetAddressstring
addressRegionstring
addressLocalitystring
postalCodeinteger
phoneNumberstring
businessEmailstring email
websiteUrlstring uri
menuUrlstring uri
orderUrlstring uri
reservationUrlstring uri
priceRangeinteger

Price range (1-5)

openingHoursobject

Opening hours by day of week

hashTagsstring

Comma-separated hash tags

mediasobject[]

Array of media objects to attach

Response

Space created successfully

idstring uuid
fromUserIdstring uuid
organizationIdstring uuid nullable
messagestring
notificationMsgstring
categorystring
latitudenumber
longitudenumber
radiusnumber
regionstring

Country code

isPublicboolean
isDraftboolean
addressReadablestring
phoneNumberstring
businessEmailstring
websiteUrlstring
menuUrlstring
orderUrlstring
reservationUrlstring
priceRangeinteger
openingHoursobject
hashTagsstring
createdAtstring date-time
updatedAtstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.