Create a location
curl --request POST \
--url https://api.qminder.com/locations \
--header 'Content-Type: application/json' \
--header 'X-Qminder-API-Version: <x-qminder-api-version>' \
--header 'X-Qminder-REST-API-Key: <api-key>' \
--data '
{
"name": "SF City Hall",
"latitude": 37.7792792,
"longitude": -122.4214304,
"address": "1 Dr Carlton B Goodlett Pl, San Francisco, CA 94102, United States",
"country": "US",
"languages": [
"en",
"et",
"fr-CA"
],
"inputFields": [
{
"id": "550e8400-e29b-41d4-a716-446655440001",
"type": "FIRST_NAME",
"isMandatoryBeforeAdded": false,
"isMandatoryBeforeServed": false,
"isMandatoryInRemoteSignIn": false,
"isVisibleInWaitingDrawer": true,
"isVisibleInServingDrawer": true,
"showInRemoteSignIn": true
},
{
"id": "550e8400-e29b-41d4-a716-446655440002",
"type": "LAST_NAME",
"isMandatoryBeforeAdded": false,
"isMandatoryBeforeServed": false,
"isMandatoryInRemoteSignIn": false,
"isVisibleInWaitingDrawer": true,
"isVisibleInServingDrawer": true,
"showInRemoteSignIn": true
},
{
"id": "550e8400-e29b-41d4-a716-446655440003",
"type": "TEXT",
"title": "Reason for visit",
"isMandatoryBeforeAdded": true,
"isMandatoryBeforeServed": false,
"isMandatoryInRemoteSignIn": false,
"isVisibleInWaitingDrawer": true,
"isVisibleInServingDrawer": true,
"showInRemoteSignIn": true
}
],
"lines": [
{
"name": "Customer Support",
"color": "TEAL"
},
{
"name": "Returns",
"color": "CORAL"
}
],
"openingHours": {
"regular": {
"mon": {
"businessHours": [
{
"opens": {
"hours": 9,
"minutes": 0
},
"closes": {
"hours": 17,
"minutes": 0
}
}
]
},
"tue": {
"businessHours": [
{
"opens": {
"hours": 9,
"minutes": 0
},
"closes": {
"hours": 17,
"minutes": 0
}
}
]
},
"wed": {
"businessHours": [
{
"opens": {
"hours": 9,
"minutes": 0
},
"closes": {
"hours": 17,
"minutes": 0
}
}
]
},
"thu": {
"businessHours": [
{
"opens": {
"hours": 9,
"minutes": 0
},
"closes": {
"hours": 17,
"minutes": 0
}
}
]
},
"fri": {
"businessHours": [
{
"opens": {
"hours": 9,
"minutes": 0
},
"closes": {
"hours": 17,
"minutes": 0
}
}
]
},
"sat": {
"closed": true
},
"sun": {
"closed": true
}
},
"exceptions": [
{
"date": "2026-05-01",
"closed": true,
"closedReason": "Holiday"
}
]
}
}
'import requests
url = "https://api.qminder.com/locations"
payload = {
"name": "SF City Hall",
"latitude": 37.7792792,
"longitude": -122.4214304,
"address": "1 Dr Carlton B Goodlett Pl, San Francisco, CA 94102, United States",
"country": "US",
"languages": ["en", "et", "fr-CA"],
"inputFields": [
{
"id": "550e8400-e29b-41d4-a716-446655440001",
"type": "FIRST_NAME",
"isMandatoryBeforeAdded": False,
"isMandatoryBeforeServed": False,
"isMandatoryInRemoteSignIn": False,
"isVisibleInWaitingDrawer": True,
"isVisibleInServingDrawer": True,
"showInRemoteSignIn": True
},
{
"id": "550e8400-e29b-41d4-a716-446655440002",
"type": "LAST_NAME",
"isMandatoryBeforeAdded": False,
"isMandatoryBeforeServed": False,
"isMandatoryInRemoteSignIn": False,
"isVisibleInWaitingDrawer": True,
"isVisibleInServingDrawer": True,
"showInRemoteSignIn": True
},
{
"id": "550e8400-e29b-41d4-a716-446655440003",
"type": "TEXT",
"title": "Reason for visit",
"isMandatoryBeforeAdded": True,
"isMandatoryBeforeServed": False,
"isMandatoryInRemoteSignIn": False,
"isVisibleInWaitingDrawer": True,
"isVisibleInServingDrawer": True,
"showInRemoteSignIn": True
}
],
"lines": [
{
"name": "Customer Support",
"color": "TEAL"
},
{
"name": "Returns",
"color": "CORAL"
}
],
"openingHours": {
"regular": {
"mon": { "businessHours": [
{
"opens": {
"hours": 9,
"minutes": 0
},
"closes": {
"hours": 17,
"minutes": 0
}
}
] },
"tue": { "businessHours": [
{
"opens": {
"hours": 9,
"minutes": 0
},
"closes": {
"hours": 17,
"minutes": 0
}
}
] },
"wed": { "businessHours": [
{
"opens": {
"hours": 9,
"minutes": 0
},
"closes": {
"hours": 17,
"minutes": 0
}
}
] },
"thu": { "businessHours": [
{
"opens": {
"hours": 9,
"minutes": 0
},
"closes": {
"hours": 17,
"minutes": 0
}
}
] },
"fri": { "businessHours": [
{
"opens": {
"hours": 9,
"minutes": 0
},
"closes": {
"hours": 17,
"minutes": 0
}
}
] },
"sat": { "closed": True },
"sun": { "closed": True }
},
"exceptions": [
{
"date": "2026-05-01",
"closed": True,
"closedReason": "Holiday"
}
]
}
}
headers = {
"X-Qminder-API-Version": "<x-qminder-api-version>",
"X-Qminder-REST-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Qminder-API-Version': '<x-qminder-api-version>',
'X-Qminder-REST-API-Key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'SF City Hall',
latitude: 37.7792792,
longitude: -122.4214304,
address: '1 Dr Carlton B Goodlett Pl, San Francisco, CA 94102, United States',
country: 'US',
languages: ['en', 'et', 'fr-CA'],
inputFields: [
{
id: '550e8400-e29b-41d4-a716-446655440001',
type: 'FIRST_NAME',
isMandatoryBeforeAdded: false,
isMandatoryBeforeServed: false,
isMandatoryInRemoteSignIn: false,
isVisibleInWaitingDrawer: true,
isVisibleInServingDrawer: true,
showInRemoteSignIn: true
},
{
id: '550e8400-e29b-41d4-a716-446655440002',
type: 'LAST_NAME',
isMandatoryBeforeAdded: false,
isMandatoryBeforeServed: false,
isMandatoryInRemoteSignIn: false,
isVisibleInWaitingDrawer: true,
isVisibleInServingDrawer: true,
showInRemoteSignIn: true
},
{
id: '550e8400-e29b-41d4-a716-446655440003',
type: 'TEXT',
title: 'Reason for visit',
isMandatoryBeforeAdded: true,
isMandatoryBeforeServed: false,
isMandatoryInRemoteSignIn: false,
isVisibleInWaitingDrawer: true,
isVisibleInServingDrawer: true,
showInRemoteSignIn: true
}
],
lines: [{name: 'Customer Support', color: 'TEAL'}, {name: 'Returns', color: 'CORAL'}],
openingHours: {
regular: {
mon: {
businessHours: [{opens: {hours: 9, minutes: 0}, closes: {hours: 17, minutes: 0}}]
},
tue: {
businessHours: [{opens: {hours: 9, minutes: 0}, closes: {hours: 17, minutes: 0}}]
},
wed: {
businessHours: [{opens: {hours: 9, minutes: 0}, closes: {hours: 17, minutes: 0}}]
},
thu: {
businessHours: [{opens: {hours: 9, minutes: 0}, closes: {hours: 17, minutes: 0}}]
},
fri: {
businessHours: [{opens: {hours: 9, minutes: 0}, closes: {hours: 17, minutes: 0}}]
},
sat: {closed: true},
sun: {closed: true}
},
exceptions: [{date: '2026-05-01', closed: true, closedReason: 'Holiday'}]
}
})
};
fetch('https://api.qminder.com/locations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.qminder.com/locations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'SF City Hall',
'latitude' => 37.7792792,
'longitude' => -122.4214304,
'address' => '1 Dr Carlton B Goodlett Pl, San Francisco, CA 94102, United States',
'country' => 'US',
'languages' => [
'en',
'et',
'fr-CA'
],
'inputFields' => [
[
'id' => '550e8400-e29b-41d4-a716-446655440001',
'type' => 'FIRST_NAME',
'isMandatoryBeforeAdded' => false,
'isMandatoryBeforeServed' => false,
'isMandatoryInRemoteSignIn' => false,
'isVisibleInWaitingDrawer' => true,
'isVisibleInServingDrawer' => true,
'showInRemoteSignIn' => true
],
[
'id' => '550e8400-e29b-41d4-a716-446655440002',
'type' => 'LAST_NAME',
'isMandatoryBeforeAdded' => false,
'isMandatoryBeforeServed' => false,
'isMandatoryInRemoteSignIn' => false,
'isVisibleInWaitingDrawer' => true,
'isVisibleInServingDrawer' => true,
'showInRemoteSignIn' => true
],
[
'id' => '550e8400-e29b-41d4-a716-446655440003',
'type' => 'TEXT',
'title' => 'Reason for visit',
'isMandatoryBeforeAdded' => true,
'isMandatoryBeforeServed' => false,
'isMandatoryInRemoteSignIn' => false,
'isVisibleInWaitingDrawer' => true,
'isVisibleInServingDrawer' => true,
'showInRemoteSignIn' => true
]
],
'lines' => [
[
'name' => 'Customer Support',
'color' => 'TEAL'
],
[
'name' => 'Returns',
'color' => 'CORAL'
]
],
'openingHours' => [
'regular' => [
'mon' => [
'businessHours' => [
[
'opens' => [
'hours' => 9,
'minutes' => 0
],
'closes' => [
'hours' => 17,
'minutes' => 0
]
]
]
],
'tue' => [
'businessHours' => [
[
'opens' => [
'hours' => 9,
'minutes' => 0
],
'closes' => [
'hours' => 17,
'minutes' => 0
]
]
]
],
'wed' => [
'businessHours' => [
[
'opens' => [
'hours' => 9,
'minutes' => 0
],
'closes' => [
'hours' => 17,
'minutes' => 0
]
]
]
],
'thu' => [
'businessHours' => [
[
'opens' => [
'hours' => 9,
'minutes' => 0
],
'closes' => [
'hours' => 17,
'minutes' => 0
]
]
]
],
'fri' => [
'businessHours' => [
[
'opens' => [
'hours' => 9,
'minutes' => 0
],
'closes' => [
'hours' => 17,
'minutes' => 0
]
]
]
],
'sat' => [
'closed' => true
],
'sun' => [
'closed' => true
]
],
'exceptions' => [
[
'date' => '2026-05-01',
'closed' => true,
'closedReason' => 'Holiday'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Qminder-API-Version: <x-qminder-api-version>",
"X-Qminder-REST-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.qminder.com/locations"
payload := strings.NewReader("{\n \"name\": \"SF City Hall\",\n \"latitude\": 37.7792792,\n \"longitude\": -122.4214304,\n \"address\": \"1 Dr Carlton B Goodlett Pl, San Francisco, CA 94102, United States\",\n \"country\": \"US\",\n \"languages\": [\n \"en\",\n \"et\",\n \"fr-CA\"\n ],\n \"inputFields\": [\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440001\",\n \"type\": \"FIRST_NAME\",\n \"isMandatoryBeforeAdded\": false,\n \"isMandatoryBeforeServed\": false,\n \"isMandatoryInRemoteSignIn\": false,\n \"isVisibleInWaitingDrawer\": true,\n \"isVisibleInServingDrawer\": true,\n \"showInRemoteSignIn\": true\n },\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440002\",\n \"type\": \"LAST_NAME\",\n \"isMandatoryBeforeAdded\": false,\n \"isMandatoryBeforeServed\": false,\n \"isMandatoryInRemoteSignIn\": false,\n \"isVisibleInWaitingDrawer\": true,\n \"isVisibleInServingDrawer\": true,\n \"showInRemoteSignIn\": true\n },\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440003\",\n \"type\": \"TEXT\",\n \"title\": \"Reason for visit\",\n \"isMandatoryBeforeAdded\": true,\n \"isMandatoryBeforeServed\": false,\n \"isMandatoryInRemoteSignIn\": false,\n \"isVisibleInWaitingDrawer\": true,\n \"isVisibleInServingDrawer\": true,\n \"showInRemoteSignIn\": true\n }\n ],\n \"lines\": [\n {\n \"name\": \"Customer Support\",\n \"color\": \"TEAL\"\n },\n {\n \"name\": \"Returns\",\n \"color\": \"CORAL\"\n }\n ],\n \"openingHours\": {\n \"regular\": {\n \"mon\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"tue\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"wed\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"thu\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"fri\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"sat\": {\n \"closed\": true\n },\n \"sun\": {\n \"closed\": true\n }\n },\n \"exceptions\": [\n {\n \"date\": \"2026-05-01\",\n \"closed\": true,\n \"closedReason\": \"Holiday\"\n }\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Qminder-API-Version", "<x-qminder-api-version>")
req.Header.Add("X-Qminder-REST-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.qminder.com/locations")
.header("X-Qminder-API-Version", "<x-qminder-api-version>")
.header("X-Qminder-REST-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"SF City Hall\",\n \"latitude\": 37.7792792,\n \"longitude\": -122.4214304,\n \"address\": \"1 Dr Carlton B Goodlett Pl, San Francisco, CA 94102, United States\",\n \"country\": \"US\",\n \"languages\": [\n \"en\",\n \"et\",\n \"fr-CA\"\n ],\n \"inputFields\": [\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440001\",\n \"type\": \"FIRST_NAME\",\n \"isMandatoryBeforeAdded\": false,\n \"isMandatoryBeforeServed\": false,\n \"isMandatoryInRemoteSignIn\": false,\n \"isVisibleInWaitingDrawer\": true,\n \"isVisibleInServingDrawer\": true,\n \"showInRemoteSignIn\": true\n },\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440002\",\n \"type\": \"LAST_NAME\",\n \"isMandatoryBeforeAdded\": false,\n \"isMandatoryBeforeServed\": false,\n \"isMandatoryInRemoteSignIn\": false,\n \"isVisibleInWaitingDrawer\": true,\n \"isVisibleInServingDrawer\": true,\n \"showInRemoteSignIn\": true\n },\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440003\",\n \"type\": \"TEXT\",\n \"title\": \"Reason for visit\",\n \"isMandatoryBeforeAdded\": true,\n \"isMandatoryBeforeServed\": false,\n \"isMandatoryInRemoteSignIn\": false,\n \"isVisibleInWaitingDrawer\": true,\n \"isVisibleInServingDrawer\": true,\n \"showInRemoteSignIn\": true\n }\n ],\n \"lines\": [\n {\n \"name\": \"Customer Support\",\n \"color\": \"TEAL\"\n },\n {\n \"name\": \"Returns\",\n \"color\": \"CORAL\"\n }\n ],\n \"openingHours\": {\n \"regular\": {\n \"mon\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"tue\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"wed\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"thu\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"fri\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"sat\": {\n \"closed\": true\n },\n \"sun\": {\n \"closed\": true\n }\n },\n \"exceptions\": [\n {\n \"date\": \"2026-05-01\",\n \"closed\": true,\n \"closedReason\": \"Holiday\"\n }\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.qminder.com/locations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Qminder-API-Version"] = '<x-qminder-api-version>'
request["X-Qminder-REST-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"SF City Hall\",\n \"latitude\": 37.7792792,\n \"longitude\": -122.4214304,\n \"address\": \"1 Dr Carlton B Goodlett Pl, San Francisco, CA 94102, United States\",\n \"country\": \"US\",\n \"languages\": [\n \"en\",\n \"et\",\n \"fr-CA\"\n ],\n \"inputFields\": [\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440001\",\n \"type\": \"FIRST_NAME\",\n \"isMandatoryBeforeAdded\": false,\n \"isMandatoryBeforeServed\": false,\n \"isMandatoryInRemoteSignIn\": false,\n \"isVisibleInWaitingDrawer\": true,\n \"isVisibleInServingDrawer\": true,\n \"showInRemoteSignIn\": true\n },\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440002\",\n \"type\": \"LAST_NAME\",\n \"isMandatoryBeforeAdded\": false,\n \"isMandatoryBeforeServed\": false,\n \"isMandatoryInRemoteSignIn\": false,\n \"isVisibleInWaitingDrawer\": true,\n \"isVisibleInServingDrawer\": true,\n \"showInRemoteSignIn\": true\n },\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440003\",\n \"type\": \"TEXT\",\n \"title\": \"Reason for visit\",\n \"isMandatoryBeforeAdded\": true,\n \"isMandatoryBeforeServed\": false,\n \"isMandatoryInRemoteSignIn\": false,\n \"isVisibleInWaitingDrawer\": true,\n \"isVisibleInServingDrawer\": true,\n \"showInRemoteSignIn\": true\n }\n ],\n \"lines\": [\n {\n \"name\": \"Customer Support\",\n \"color\": \"TEAL\"\n },\n {\n \"name\": \"Returns\",\n \"color\": \"CORAL\"\n }\n ],\n \"openingHours\": {\n \"regular\": {\n \"mon\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"tue\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"wed\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"thu\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"fri\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"sat\": {\n \"closed\": true\n },\n \"sun\": {\n \"closed\": true\n }\n },\n \"exceptions\": [\n {\n \"date\": \"2026-05-01\",\n \"closed\": true,\n \"closedReason\": \"Holiday\"\n }\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "12345"
}Locations
Create a location
Creates a new location in the account.
POST
/
locations
Create a location
curl --request POST \
--url https://api.qminder.com/locations \
--header 'Content-Type: application/json' \
--header 'X-Qminder-API-Version: <x-qminder-api-version>' \
--header 'X-Qminder-REST-API-Key: <api-key>' \
--data '
{
"name": "SF City Hall",
"latitude": 37.7792792,
"longitude": -122.4214304,
"address": "1 Dr Carlton B Goodlett Pl, San Francisco, CA 94102, United States",
"country": "US",
"languages": [
"en",
"et",
"fr-CA"
],
"inputFields": [
{
"id": "550e8400-e29b-41d4-a716-446655440001",
"type": "FIRST_NAME",
"isMandatoryBeforeAdded": false,
"isMandatoryBeforeServed": false,
"isMandatoryInRemoteSignIn": false,
"isVisibleInWaitingDrawer": true,
"isVisibleInServingDrawer": true,
"showInRemoteSignIn": true
},
{
"id": "550e8400-e29b-41d4-a716-446655440002",
"type": "LAST_NAME",
"isMandatoryBeforeAdded": false,
"isMandatoryBeforeServed": false,
"isMandatoryInRemoteSignIn": false,
"isVisibleInWaitingDrawer": true,
"isVisibleInServingDrawer": true,
"showInRemoteSignIn": true
},
{
"id": "550e8400-e29b-41d4-a716-446655440003",
"type": "TEXT",
"title": "Reason for visit",
"isMandatoryBeforeAdded": true,
"isMandatoryBeforeServed": false,
"isMandatoryInRemoteSignIn": false,
"isVisibleInWaitingDrawer": true,
"isVisibleInServingDrawer": true,
"showInRemoteSignIn": true
}
],
"lines": [
{
"name": "Customer Support",
"color": "TEAL"
},
{
"name": "Returns",
"color": "CORAL"
}
],
"openingHours": {
"regular": {
"mon": {
"businessHours": [
{
"opens": {
"hours": 9,
"minutes": 0
},
"closes": {
"hours": 17,
"minutes": 0
}
}
]
},
"tue": {
"businessHours": [
{
"opens": {
"hours": 9,
"minutes": 0
},
"closes": {
"hours": 17,
"minutes": 0
}
}
]
},
"wed": {
"businessHours": [
{
"opens": {
"hours": 9,
"minutes": 0
},
"closes": {
"hours": 17,
"minutes": 0
}
}
]
},
"thu": {
"businessHours": [
{
"opens": {
"hours": 9,
"minutes": 0
},
"closes": {
"hours": 17,
"minutes": 0
}
}
]
},
"fri": {
"businessHours": [
{
"opens": {
"hours": 9,
"minutes": 0
},
"closes": {
"hours": 17,
"minutes": 0
}
}
]
},
"sat": {
"closed": true
},
"sun": {
"closed": true
}
},
"exceptions": [
{
"date": "2026-05-01",
"closed": true,
"closedReason": "Holiday"
}
]
}
}
'import requests
url = "https://api.qminder.com/locations"
payload = {
"name": "SF City Hall",
"latitude": 37.7792792,
"longitude": -122.4214304,
"address": "1 Dr Carlton B Goodlett Pl, San Francisco, CA 94102, United States",
"country": "US",
"languages": ["en", "et", "fr-CA"],
"inputFields": [
{
"id": "550e8400-e29b-41d4-a716-446655440001",
"type": "FIRST_NAME",
"isMandatoryBeforeAdded": False,
"isMandatoryBeforeServed": False,
"isMandatoryInRemoteSignIn": False,
"isVisibleInWaitingDrawer": True,
"isVisibleInServingDrawer": True,
"showInRemoteSignIn": True
},
{
"id": "550e8400-e29b-41d4-a716-446655440002",
"type": "LAST_NAME",
"isMandatoryBeforeAdded": False,
"isMandatoryBeforeServed": False,
"isMandatoryInRemoteSignIn": False,
"isVisibleInWaitingDrawer": True,
"isVisibleInServingDrawer": True,
"showInRemoteSignIn": True
},
{
"id": "550e8400-e29b-41d4-a716-446655440003",
"type": "TEXT",
"title": "Reason for visit",
"isMandatoryBeforeAdded": True,
"isMandatoryBeforeServed": False,
"isMandatoryInRemoteSignIn": False,
"isVisibleInWaitingDrawer": True,
"isVisibleInServingDrawer": True,
"showInRemoteSignIn": True
}
],
"lines": [
{
"name": "Customer Support",
"color": "TEAL"
},
{
"name": "Returns",
"color": "CORAL"
}
],
"openingHours": {
"regular": {
"mon": { "businessHours": [
{
"opens": {
"hours": 9,
"minutes": 0
},
"closes": {
"hours": 17,
"minutes": 0
}
}
] },
"tue": { "businessHours": [
{
"opens": {
"hours": 9,
"minutes": 0
},
"closes": {
"hours": 17,
"minutes": 0
}
}
] },
"wed": { "businessHours": [
{
"opens": {
"hours": 9,
"minutes": 0
},
"closes": {
"hours": 17,
"minutes": 0
}
}
] },
"thu": { "businessHours": [
{
"opens": {
"hours": 9,
"minutes": 0
},
"closes": {
"hours": 17,
"minutes": 0
}
}
] },
"fri": { "businessHours": [
{
"opens": {
"hours": 9,
"minutes": 0
},
"closes": {
"hours": 17,
"minutes": 0
}
}
] },
"sat": { "closed": True },
"sun": { "closed": True }
},
"exceptions": [
{
"date": "2026-05-01",
"closed": True,
"closedReason": "Holiday"
}
]
}
}
headers = {
"X-Qminder-API-Version": "<x-qminder-api-version>",
"X-Qminder-REST-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Qminder-API-Version': '<x-qminder-api-version>',
'X-Qminder-REST-API-Key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'SF City Hall',
latitude: 37.7792792,
longitude: -122.4214304,
address: '1 Dr Carlton B Goodlett Pl, San Francisco, CA 94102, United States',
country: 'US',
languages: ['en', 'et', 'fr-CA'],
inputFields: [
{
id: '550e8400-e29b-41d4-a716-446655440001',
type: 'FIRST_NAME',
isMandatoryBeforeAdded: false,
isMandatoryBeforeServed: false,
isMandatoryInRemoteSignIn: false,
isVisibleInWaitingDrawer: true,
isVisibleInServingDrawer: true,
showInRemoteSignIn: true
},
{
id: '550e8400-e29b-41d4-a716-446655440002',
type: 'LAST_NAME',
isMandatoryBeforeAdded: false,
isMandatoryBeforeServed: false,
isMandatoryInRemoteSignIn: false,
isVisibleInWaitingDrawer: true,
isVisibleInServingDrawer: true,
showInRemoteSignIn: true
},
{
id: '550e8400-e29b-41d4-a716-446655440003',
type: 'TEXT',
title: 'Reason for visit',
isMandatoryBeforeAdded: true,
isMandatoryBeforeServed: false,
isMandatoryInRemoteSignIn: false,
isVisibleInWaitingDrawer: true,
isVisibleInServingDrawer: true,
showInRemoteSignIn: true
}
],
lines: [{name: 'Customer Support', color: 'TEAL'}, {name: 'Returns', color: 'CORAL'}],
openingHours: {
regular: {
mon: {
businessHours: [{opens: {hours: 9, minutes: 0}, closes: {hours: 17, minutes: 0}}]
},
tue: {
businessHours: [{opens: {hours: 9, minutes: 0}, closes: {hours: 17, minutes: 0}}]
},
wed: {
businessHours: [{opens: {hours: 9, minutes: 0}, closes: {hours: 17, minutes: 0}}]
},
thu: {
businessHours: [{opens: {hours: 9, minutes: 0}, closes: {hours: 17, minutes: 0}}]
},
fri: {
businessHours: [{opens: {hours: 9, minutes: 0}, closes: {hours: 17, minutes: 0}}]
},
sat: {closed: true},
sun: {closed: true}
},
exceptions: [{date: '2026-05-01', closed: true, closedReason: 'Holiday'}]
}
})
};
fetch('https://api.qminder.com/locations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.qminder.com/locations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'SF City Hall',
'latitude' => 37.7792792,
'longitude' => -122.4214304,
'address' => '1 Dr Carlton B Goodlett Pl, San Francisco, CA 94102, United States',
'country' => 'US',
'languages' => [
'en',
'et',
'fr-CA'
],
'inputFields' => [
[
'id' => '550e8400-e29b-41d4-a716-446655440001',
'type' => 'FIRST_NAME',
'isMandatoryBeforeAdded' => false,
'isMandatoryBeforeServed' => false,
'isMandatoryInRemoteSignIn' => false,
'isVisibleInWaitingDrawer' => true,
'isVisibleInServingDrawer' => true,
'showInRemoteSignIn' => true
],
[
'id' => '550e8400-e29b-41d4-a716-446655440002',
'type' => 'LAST_NAME',
'isMandatoryBeforeAdded' => false,
'isMandatoryBeforeServed' => false,
'isMandatoryInRemoteSignIn' => false,
'isVisibleInWaitingDrawer' => true,
'isVisibleInServingDrawer' => true,
'showInRemoteSignIn' => true
],
[
'id' => '550e8400-e29b-41d4-a716-446655440003',
'type' => 'TEXT',
'title' => 'Reason for visit',
'isMandatoryBeforeAdded' => true,
'isMandatoryBeforeServed' => false,
'isMandatoryInRemoteSignIn' => false,
'isVisibleInWaitingDrawer' => true,
'isVisibleInServingDrawer' => true,
'showInRemoteSignIn' => true
]
],
'lines' => [
[
'name' => 'Customer Support',
'color' => 'TEAL'
],
[
'name' => 'Returns',
'color' => 'CORAL'
]
],
'openingHours' => [
'regular' => [
'mon' => [
'businessHours' => [
[
'opens' => [
'hours' => 9,
'minutes' => 0
],
'closes' => [
'hours' => 17,
'minutes' => 0
]
]
]
],
'tue' => [
'businessHours' => [
[
'opens' => [
'hours' => 9,
'minutes' => 0
],
'closes' => [
'hours' => 17,
'minutes' => 0
]
]
]
],
'wed' => [
'businessHours' => [
[
'opens' => [
'hours' => 9,
'minutes' => 0
],
'closes' => [
'hours' => 17,
'minutes' => 0
]
]
]
],
'thu' => [
'businessHours' => [
[
'opens' => [
'hours' => 9,
'minutes' => 0
],
'closes' => [
'hours' => 17,
'minutes' => 0
]
]
]
],
'fri' => [
'businessHours' => [
[
'opens' => [
'hours' => 9,
'minutes' => 0
],
'closes' => [
'hours' => 17,
'minutes' => 0
]
]
]
],
'sat' => [
'closed' => true
],
'sun' => [
'closed' => true
]
],
'exceptions' => [
[
'date' => '2026-05-01',
'closed' => true,
'closedReason' => 'Holiday'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Qminder-API-Version: <x-qminder-api-version>",
"X-Qminder-REST-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.qminder.com/locations"
payload := strings.NewReader("{\n \"name\": \"SF City Hall\",\n \"latitude\": 37.7792792,\n \"longitude\": -122.4214304,\n \"address\": \"1 Dr Carlton B Goodlett Pl, San Francisco, CA 94102, United States\",\n \"country\": \"US\",\n \"languages\": [\n \"en\",\n \"et\",\n \"fr-CA\"\n ],\n \"inputFields\": [\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440001\",\n \"type\": \"FIRST_NAME\",\n \"isMandatoryBeforeAdded\": false,\n \"isMandatoryBeforeServed\": false,\n \"isMandatoryInRemoteSignIn\": false,\n \"isVisibleInWaitingDrawer\": true,\n \"isVisibleInServingDrawer\": true,\n \"showInRemoteSignIn\": true\n },\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440002\",\n \"type\": \"LAST_NAME\",\n \"isMandatoryBeforeAdded\": false,\n \"isMandatoryBeforeServed\": false,\n \"isMandatoryInRemoteSignIn\": false,\n \"isVisibleInWaitingDrawer\": true,\n \"isVisibleInServingDrawer\": true,\n \"showInRemoteSignIn\": true\n },\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440003\",\n \"type\": \"TEXT\",\n \"title\": \"Reason for visit\",\n \"isMandatoryBeforeAdded\": true,\n \"isMandatoryBeforeServed\": false,\n \"isMandatoryInRemoteSignIn\": false,\n \"isVisibleInWaitingDrawer\": true,\n \"isVisibleInServingDrawer\": true,\n \"showInRemoteSignIn\": true\n }\n ],\n \"lines\": [\n {\n \"name\": \"Customer Support\",\n \"color\": \"TEAL\"\n },\n {\n \"name\": \"Returns\",\n \"color\": \"CORAL\"\n }\n ],\n \"openingHours\": {\n \"regular\": {\n \"mon\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"tue\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"wed\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"thu\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"fri\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"sat\": {\n \"closed\": true\n },\n \"sun\": {\n \"closed\": true\n }\n },\n \"exceptions\": [\n {\n \"date\": \"2026-05-01\",\n \"closed\": true,\n \"closedReason\": \"Holiday\"\n }\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Qminder-API-Version", "<x-qminder-api-version>")
req.Header.Add("X-Qminder-REST-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.qminder.com/locations")
.header("X-Qminder-API-Version", "<x-qminder-api-version>")
.header("X-Qminder-REST-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"SF City Hall\",\n \"latitude\": 37.7792792,\n \"longitude\": -122.4214304,\n \"address\": \"1 Dr Carlton B Goodlett Pl, San Francisco, CA 94102, United States\",\n \"country\": \"US\",\n \"languages\": [\n \"en\",\n \"et\",\n \"fr-CA\"\n ],\n \"inputFields\": [\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440001\",\n \"type\": \"FIRST_NAME\",\n \"isMandatoryBeforeAdded\": false,\n \"isMandatoryBeforeServed\": false,\n \"isMandatoryInRemoteSignIn\": false,\n \"isVisibleInWaitingDrawer\": true,\n \"isVisibleInServingDrawer\": true,\n \"showInRemoteSignIn\": true\n },\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440002\",\n \"type\": \"LAST_NAME\",\n \"isMandatoryBeforeAdded\": false,\n \"isMandatoryBeforeServed\": false,\n \"isMandatoryInRemoteSignIn\": false,\n \"isVisibleInWaitingDrawer\": true,\n \"isVisibleInServingDrawer\": true,\n \"showInRemoteSignIn\": true\n },\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440003\",\n \"type\": \"TEXT\",\n \"title\": \"Reason for visit\",\n \"isMandatoryBeforeAdded\": true,\n \"isMandatoryBeforeServed\": false,\n \"isMandatoryInRemoteSignIn\": false,\n \"isVisibleInWaitingDrawer\": true,\n \"isVisibleInServingDrawer\": true,\n \"showInRemoteSignIn\": true\n }\n ],\n \"lines\": [\n {\n \"name\": \"Customer Support\",\n \"color\": \"TEAL\"\n },\n {\n \"name\": \"Returns\",\n \"color\": \"CORAL\"\n }\n ],\n \"openingHours\": {\n \"regular\": {\n \"mon\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"tue\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"wed\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"thu\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"fri\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"sat\": {\n \"closed\": true\n },\n \"sun\": {\n \"closed\": true\n }\n },\n \"exceptions\": [\n {\n \"date\": \"2026-05-01\",\n \"closed\": true,\n \"closedReason\": \"Holiday\"\n }\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.qminder.com/locations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Qminder-API-Version"] = '<x-qminder-api-version>'
request["X-Qminder-REST-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"SF City Hall\",\n \"latitude\": 37.7792792,\n \"longitude\": -122.4214304,\n \"address\": \"1 Dr Carlton B Goodlett Pl, San Francisco, CA 94102, United States\",\n \"country\": \"US\",\n \"languages\": [\n \"en\",\n \"et\",\n \"fr-CA\"\n ],\n \"inputFields\": [\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440001\",\n \"type\": \"FIRST_NAME\",\n \"isMandatoryBeforeAdded\": false,\n \"isMandatoryBeforeServed\": false,\n \"isMandatoryInRemoteSignIn\": false,\n \"isVisibleInWaitingDrawer\": true,\n \"isVisibleInServingDrawer\": true,\n \"showInRemoteSignIn\": true\n },\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440002\",\n \"type\": \"LAST_NAME\",\n \"isMandatoryBeforeAdded\": false,\n \"isMandatoryBeforeServed\": false,\n \"isMandatoryInRemoteSignIn\": false,\n \"isVisibleInWaitingDrawer\": true,\n \"isVisibleInServingDrawer\": true,\n \"showInRemoteSignIn\": true\n },\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440003\",\n \"type\": \"TEXT\",\n \"title\": \"Reason for visit\",\n \"isMandatoryBeforeAdded\": true,\n \"isMandatoryBeforeServed\": false,\n \"isMandatoryInRemoteSignIn\": false,\n \"isVisibleInWaitingDrawer\": true,\n \"isVisibleInServingDrawer\": true,\n \"showInRemoteSignIn\": true\n }\n ],\n \"lines\": [\n {\n \"name\": \"Customer Support\",\n \"color\": \"TEAL\"\n },\n {\n \"name\": \"Returns\",\n \"color\": \"CORAL\"\n }\n ],\n \"openingHours\": {\n \"regular\": {\n \"mon\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"tue\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"wed\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"thu\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"fri\": {\n \"businessHours\": [\n {\n \"opens\": {\n \"hours\": 9,\n \"minutes\": 0\n },\n \"closes\": {\n \"hours\": 17,\n \"minutes\": 0\n }\n }\n ]\n },\n \"sat\": {\n \"closed\": true\n },\n \"sun\": {\n \"closed\": true\n }\n },\n \"exceptions\": [\n {\n \"date\": \"2026-05-01\",\n \"closed\": true,\n \"closedReason\": \"Holiday\"\n }\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "12345"
}Authorizations
Headers
API version. Must be set to 2020-09-01.
Available options:
2020-09-01 Body
application/json
Location name (max 30 characters).
Maximum string length:
30Geographical latitude (-90 to 90).
Required range:
-90 <= x <= 90Geographical longitude (-180 to 180).
Required range:
-180 <= x <= 180Postal address (max 300 characters).
Maximum string length:
300ISO 3166-1 alpha-2 country code (e.g. "US", "CA").
Pattern:
^[A-Z]{2}$Languages available at this location. An array of ISO 639 / BCP 47 language codes (e.g. "en", "et", "fr-CA"). Must include "en". No duplicates allowed. Order is preserved. Defaults to ["en"] if omitted.
Custom input fields to create with the location. If omitted, three default fields are created (first name, last name, phone number). Must include at least one FIRST_NAME and one LAST_NAME field. Each field uses the same schema as POST /input-fields, but without location and visibleForLines.
Maximum array length:
50Show child attributes
Show child attributes
Custom lines (queues) to create with the location. If omitted, two default lines are created ("Main Service" and "Information"). Uses the same schema as POST /locations/{id}/lines, but without appointmentSettings.
Required array length:
1 - 50 elementsShow child attributes
Show child attributes
Opening hours configuration. If omitted, the location defaults to 24/7 (00:00–23:59 every day).
Show child attributes
Show child attributes
Response
Location created successfully
The ID of the created location.
Example:
"12345"
⌘I