Description

Creates a new service location. The user making the request MUST have role "multisite_api" or "multisite_helpdesk". If this is not the case, an HTTP error 403 is returned.

Resource URL

https://app1pub.smappee.net/dev/v3/servicelocation

HTTP method

POST

HTTP header

Authorization: Bearer [ACCESS_TOKEN]

[ACCESS_TOKEN] being the access token received from the Get token or Refresh token authentication calls.

Http body

{
  "name": "Example",
  "deviceType": "PRO",
  "timeZone": "Europe/Brussels",
  "longitude": "4.35",
  "latitude": "50.85",
  "currency": "EUR"
}

The "name" is required but we are lenient and will apply default "Home" when name is missing.

The device type is required and will return HTTP error 400 when missing.

The longitude and latitude are both optional.

The time zone is optional.

The currency is optional and we will apply "EUR" as a default when missing.

Versioning

Version 1 (v1)

This call does not exist in this version

Version 2 (v2)

This call was introduced in this version

Content

Smappee API

Create service location