Skip to main content
POST
/
vendor
/
{org_token}
/
locations
Create a Location
curl --request POST \
  --url https://api.framen.com/vendor/{org_token}/locations \
  --header 'Content-Type: application/json' \
  --data '
{
  "location_id": "<string>",
  "title": "<string>",
  "venue_type_id": "<string>",
  "lat": 123,
  "long": 123,
  "opening_168": {},
  "visitors_7": {},
  "archived": true,
  "email": "<string>",
  "phone": "<string>"
}
'

​
Create a Location

Register a new physical location in your organization. The location will initially be created with a DRAFT status and must be approved before screens can be deployed. Locations go through an approval process: DRAFT -> REVIEW -> APPROVED. Providing all “required for Review” fields automatically moves the status to REVIEW. FRAMEN then performs the approval.
​
org_token
string
required
Your organization token (e.g., Org_4KmTqZnWpLx).
​
location_id
string
Your unique identifier for this location. If not provided, one will be assigned automatically.
​
title
string
required
Display name of the location.
​
venue_type_id
string
Must be a level 2 venue type ID from the Venue Types endpoint. Required for Review.
​
lat
number
Latitude coordinate (WGS84, range: -90 to 90). Required for Review.
​
long
number
Longitude coordinate (WGS84, range: -180 to 180). Required for Review.
​
opening_168
boolean[168]
Hourly opening schedule for one week (168 booleans). Index 0 = Monday 00:00. Required for Review.
​
visitors_7
int[7]
Daily visitor counts, Monday through Sunday. Required for Review.
​
archived
boolean
Whether the location is archived. Default: false.
​
email
string
Contact email for the location.
​
phone
string
Contact phone number for the location.

​
Example Request

curl -X POST https://api.framen.com/vendor/{org_token}/locations \
  -H "Content-Type: application/json" \
  -d '{
        "location_id": "Loc_MyCustomId123",
    "title": "Berlin Hauptbahnhof",
    "venue_type_id": "205",
    "lat": 52.5251,
    "long": 13.3694,
    "opening_168": [true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, false, false, false, false, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, false, false, false, false, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, false, false, false, false, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, false, false, false, false, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, false, false, false, false, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, false, false, false, false, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, false, false, false, false],
    "visitors_7": [500, 600, 700, 800, 900, 1000, 400]
  }'
Last modified on June 8, 2026