v1

latestOpenAPI 3.0.12026-07-243686491.1 MB

Sites

Create a (charge) site

Required scope: charge-points:write </br>Organization authorization: supported

post/api/v1/sites

Request body

operatorIdinteger nullable

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

teamIdinteger required

Id of the team that the site belongs to

namestring required

Name of the site

latitudenumber nullable

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

longitudenumber nullable

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

visibility'private' | 'public' required

showOnMapboolean nullable

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.

partnerExternalIdstring nullable

External Id of this entity, managed by you.

partnerCustomPayloadobject[] nullable

Custom JSON payload for this entity, managed by you.

notestring nullable

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

Example request

{
  "operatorId": 1,
  "teamId": 13,
  "name": "Monta CPH Site",
  "address": {
    "address1": "Strandboulevarden 122",
    "address2": "København",
    "address3": "5. sal",
    "city": "Berlin",
    "zipCode": "10011",
    "countryId": 194,
    "countryAreaId": 1
  },
  "latitude": 55.6761,
  "longitude": 12.5683,
  "showOnMap": true,
  "partnerExternalId": "ACME-12345",
  "metadata": {
    "amenities": [
      {
        "value": true
      }
    ],
    "energyMix": {
      "isGreenEnergy": true,
      "energySources": [
        {
          "percentage": 40
        }
      ],
      "environImpact": [
        {
          "amount": 12.5
        }
      ],
      "supplierName": "Green Energy Supplier",
      "energyProductName": "EcoPower 2025"
    },
    "openingHours": {
      "openingTimes": {
        "regularHours": [
          {
            "weekday": 1,
            "periodBegin": "08:00",
            "periodEnd": "17:00"
          }
        ],
        "exceptionalOpenings": [
          {
            "periodBegin": "2025-06-01T08:00:00Z",
            "periodEnd": "2025-06-01T18:00:00Z"
          }
        ],
        "exceptionalClosings": [
          {
            "periodBegin": "2025-06-01T08:00:00Z",
            "periodEnd": "2025-06-01T18:00:00Z"
          }
        ]
      },
      "chargingWhenClosed": true
    },
    "siteDeveloper": {
      "name": "John Doe",
      "email": "john.doe@example.com",
      "companyRegistrationNumber": "12345678"
    }
  },
  "note": "Main entrance on north side"
}

Response

Site created