API Reference
Monta.com

Create a (charge) site

post
https://partner-api.monta.com/api/v1/sites

Required scope: charge-points:write
Organization authorization: supported

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
int64 | null
> 0

Id of the operator this site should be assigned to.
Note: if not provided the site will be assigned to the default operator for the given consumer.

int64
required

Id of the team that the site belongs to

string
required
length ≥ 1

Name of the site

address
object
required

Address of the site. countryId is always required. address1, city, and zipCode must either all be provided (geocoding will resolve coordinates) or all be left null — in which case latitude and longitude must be supplied instead. Partial addresses are rejected.

number | null
-90 to 90

Latitude coordinate for the site location. Required when the address (address1/city/zipCode) is omitted. When provided along with longitude, overrides geocoding from address.

number | null
-180 to 180

Longitude coordinate for the site location. Required when the address (address1/city/zipCode) is omitted. When provided along with latitude, overrides geocoding from address.

string
enum
required

Visibility type of the site. Controls who can charge at the site: public means any Monta user can charge here, private restricts charging to team members / access-token holders. This field does NOT control whether the site appears on the consumer map — use showOnMap for that.

Allowed:
boolean | null

Whether this site should be visible on the consumer map. If omitted, the site will be visible on the map by default. This is independent of visibility — a private site can still be shown on the map, and a public site can be hidden.

string | null

External Id of this entity, managed by you.

partnerCustomPayload
object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys. The payload is limited to 1000 characters.

metadata
object | null

Metadata for the site including amenities, energy mix, opening hours, site developer, and pictures.

string | null

A free-text note for this site, visible in the app.

Responses

422

Validation failed, e.g. metadata.energy_mix claims green energy without backing (see is_green_energy)

Updated 2 months ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 months ago

Did this page help you?