Skip to main content
POST
/
location
Create a new restaurant location
curl --request POST \
  --url https://api.example.com/location \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Pizzeria Da Mario",
  "currency": "CHF",
  "address": {
    "address": "123 Main Street",
    "postalCode": "1204",
    "city": "Geneva",
    "address2": "Suite 101",
    "country": "CH",
    "latitude": 46.2044,
    "longitude": 6.1432
  },
  "timezone": "Europe/Zurich",
  "country": "CH",
  "imageId": "img_12345",
  "openingHours": {
    "pickup": {
      "monday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "tuesday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "wednesday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "thursday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "friday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "saturday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "sunday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ]
    },
    "delivery": {
      "monday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "tuesday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "wednesday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "thursday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "friday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "saturday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "sunday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ]
    }
  },
  "contactInformation": "Phone: +41 22 123 4567\nEmail: [email protected]",
  "businessOrganizationId": "bizorg_12345",
  "defaultLanguage": "fr"
}
'
{
  "id": "loc_12345",
  "name": "Pizzeria Da Mario",
  "currency": "CHF",
  "country": "CH",
  "address": {
    "address": "123 Main Street",
    "postalCode": "1204",
    "city": "Geneva",
    "address2": "Suite 101",
    "country": "CH",
    "latitude": 46.2044,
    "longitude": 6.1432
  },
  "timezone": "Europe/Zurich",
  "openingHours": {
    "pickup": {
      "monday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "tuesday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "wednesday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "thursday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "friday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "saturday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "sunday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ]
    },
    "delivery": {
      "monday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "tuesday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "wednesday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "thursday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "friday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "saturday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "sunday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ]
    }
  },
  "catalogs": [
    {}
  ],
  "organizationId": "org_12345",
  "integrations": {},
  "deliverySettings": {
    "mode": "postalCode",
    "postalCodes": [
      {
        "postalCode": 1204,
        "minimumOrderAmount": 2000,
        "deliveryFee": {
          "amount": 995,
          "currency": "CHF",
          "formatted": "CHF 9.95"
        }
      }
    ],
    "feeSharing": {
      "mode": "customerPaysAll",
      "percentage": 70
    },
    "chaskisFlatFee": {
      "amount": 995,
      "currency": "CHF",
      "formatted": "CHF 9.95"
    },
    "chaskisPerKmFee": {
      "amount": 995,
      "currency": "CHF",
      "formatted": "CHF 9.95"
    }
  },
  "paymentSettings": {
    "mode": "stripe",
    "paymentMethods": [
      "card",
      "apple_pay",
      "google_pay",
      "twint"
    ]
  },
  "averagePreparationTime": {
    "hour": 1,
    "minute": 30
  },
  "minOrderAmount": 2000,
  "autoAcceptOrders": true,
  "defaultLanguage": "fr",
  "acceptanceSettings": {
    "mode": "online",
    "extraPreparationTime": 10,
    "reason": "We are closed for the day"
  },
  "image": {
    "id": "img_12345",
    "url": "https://cdn.example.com/images/img_12345.jpg",
    "mediumCompressedUrl": "https://cdn.example.com/images/img_12345_medium.jpg",
    "smallCompressedUrl": "https://cdn.example.com/images/img_12345_small.jpg",
    "base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEA...",
    "mediumBase64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEA..."
  },
  "contactInformation": "Phone: +41 22 123 4567\nEmail: [email protected]"
}

Body

application/json

Restaurant location details

​
name
string
required

Restaurant name

Example:

"Pizzeria Da Mario"

​
currency
enum<string>
required

Currency used by the restaurant

Available options:
CHF,
EUR,
USD
Example:

"CHF"

​
address
object
required

Address information

​
timezone
string
required

IANA timezone string

Example:

"Europe/Zurich"

​
country
enum<string>
required

Country where the restaurant is located

Available options:
CH,
FR
Example:

"CH"

​
imageId
string

ID of the uploaded restaurant image

Example:

"img_12345"

​
openingHours
object

Opening hours by day of the week

​
contactInformation
string

Contact information (phone numbers, emails)

Example:

"Phone: +41 22 123 4567\nEmail: [email protected]"

​
businessOrganizationId
string

Business organization ID if location belongs to one

Example:

"bizorg_12345"

​
defaultLanguage
enum<string>

Default language for the restaurant location

Available options:
fr,
en,
de,
it,
es
Example:

"fr"

Response

Location created successfully

​
id
string
required

Location ID

Example:

"loc_12345"

​
name
string
required

Location name

Example:

"Pizzeria Da Mario"

​
currency
enum<string>
required

Currency used by the location

Available options:
CHF,
EUR,
USD
Example:

"CHF"

​
country
enum<string>
required

Country where the location is situated

Available options:
CH,
FR
Example:

"CH"

​
address
object
required

Location address

​
timezone
string
required

Location timezone

Example:

"Europe/Zurich"

​
openingHours
object
required

Location opening hours

​
catalogs
object[]
required

Location catalogs

​
organizationId
string
required

Location organization ID

Example:

"org_12345"

​
integrations
object
required

Location integrations

​
deliverySettings
object
required

Location delivery settings

​
paymentSettings
object
required

Location payment settings

​
averagePreparationTime
object
required

Average preparation time for orders

​
minOrderAmount
number
required

Minimum order amount in smallest currency unit (e.g. cents)

Example:

2000

​
autoAcceptOrders
boolean
required

Auto accept orders

Example:

true

​
defaultLanguage
enum<string>
required

Default language for the restaurant location

Available options:
fr,
en,
de,
it,
es
Example:

"fr"

​
acceptanceSettings
object
required

Location acceptance settings

​
image
object

Location image

​
contactInformation
string

Location contact information

Example:

"Phone: +41 22 123 4567\nEmail: [email protected]"