Create Location
Locations
Create Location
POST
Create Location
Creates a new location and assigns it to the authenticated user’s team. If the user does not have a team, a personal team is automatically created.
string
The UUID of the team to assign the location to. Must be a team the authenticated user belongs to. If omitted, the location is assigned to the user’s first team.
string
required
The name of the location. Maximum 255 characters.
string
required
The street name. Maximum 255 characters.
number
required
The house number. Must be 0 or greater.
string
The house number addition (e.g., “A”, “B”). Maximum 255 characters.
string
required
The postal code. Maximum 255 characters.
string
required
The city name. Maximum 255 characters.
string
required
The ISO 3166-1 alpha-2 country code (e.g., “NL”, “DE”). Maximum 2 characters.
boolean
Whether the location’s coordinates are set manually. When
true, latitude and longitude are required; otherwise the coordinates are geocoded from the address.number
The latitude of the location. Must be between -90 and 90. Required when
manual_coordinates is true.number
The longitude of the location. Must be between -180 and 180. Required when
manual_coordinates is true.Response
string
The unique UUID of the location.
integer
The numeric ID of the location.
string
The name of the location.
string
The full formatted address of the location.
string
The street name.
string
The postal code.
integer
The house number.
string
The house number addition. May be
null.string
The city name.
string
The ISO 3166-1 alpha-2 country code.
string
The tariff zone key used for day-ahead pricing lookups. May be
null.number
The latitude of the location. May be
null.number
The longitude of the location. May be
null.boolean
Whether the location’s coordinates were set manually rather than geocoded automatically.
string
The access level of the location. One of
closed, app_users, or roaming.string
The smart charging mode of the location. One of
disabled, off_peak, or day_ahead_pricing.integer
The number of chargers assigned to this location.
object
The location’s available capabilities based on licensing.
string
ISO 8601 timestamp of when the location was created.
string
ISO 8601 timestamp of when the location was last updated.
object
The authenticated user’s permissions for this location.