---
title: "Create a vehicle ID intent"
method: POST
path: "/api/v1/energy/sites/{siteId}/vehicles"
tags: ["Energy Charge Intents"]
---

# Create a vehicle ID intent

`POST /api/v1/energy/sites/{siteId}/vehicles`

## Request

- Base URL: `https://partner-api.monta.com`
- URL: `https://partner-api.monta.com/api/v1/energy/sites/{siteId}/vehicles`
- Auth: HTTP bearer

Required scope: `energy:write`

🚧 **BETA** — This endpoint is currently in the BETA phase and its response structure may change in the future.

📘 **Feature flag required** — This endpoint is not available by default. It must be explicitly enabled for your operator account upon request. Please contact your Monta Business Partner to request access to this feature.

## Path parameters

- `siteId` integer, required

## Request body

- CreateVehicleIdIntent
  - `vehicleIdTag` string, required
  - `vehicleId` integer, nullable
  - `batteryCapacityKwh` number, double, required
  - `type` 'PRICE_OPTIMIZE' | 'CHARGE_NOW', required
  - `departureTime` string, partial-time, nullable
  - `target` Target
    - `soc` number, double, nullable
    - `kwh` number, double, nullable
  - `scheduleOverrides` ScheduleOverride[], required
    - `id` string, nullable
    - `startDay` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY', required
    - `startTime` string, partial-time, required
    - `endDay` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY', required
    - `endTime` string, partial-time, required
    - `type` 'PRICE_OPTIMIZE' | 'CHARGE_NOW', required
    - `departureDay` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY'
    - `departureTime` string, partial-time, nullable
    - `target` Target
      - `soc` number, double, nullable
      - `kwh` number, double, nullable

## Response `201`

createVehicleIdIntent 201 response

- Vehicle
  - `vehicleId` integer, nullable
  - `vehicleIdTag` string, required
  - `batteryCapacityKwh` number, double, nullable
  - `chargeIntent` ChargeIntent, required
    - `type` 'PRICE_OPTIMIZE' | 'CHARGE_NOW', required
    - `departureTime` string, partial-time, nullable
    - `target` Target
      - `soc` number, double, nullable
      - `kwh` number, double, nullable
    - `scheduleOverrides` ScheduleOverride[], required
      - `id` string, nullable
      - `startDay` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY', required
      - `startTime` string, partial-time, required
      - `endDay` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY', required
      - `endTime` string, partial-time, required
      - `type` 'PRICE_OPTIMIZE' | 'CHARGE_NOW', required
      - `departureDay` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY'
      - `departureTime` string, partial-time, nullable
      - `target` Target
        - `soc` number, double, nullable
        - `kwh` number, double, nullable
    - `priority` integer, nullable
  - `integrationCapacityKwh` number, double, nullable
  - `maxKwAc` number, double, nullable
  - `maxKwDc` number, double, nullable

## Other responses

- `400`: The request is invalid
- `401`: Consumer with provided credentials was not found
- `403`: Operator doesn't have access to resource
- `404`: Entity with the provided id was not found

## Changes

- **2026-11-03** `0ca400461c52`: 8 breaking, 10 info
  - added the new required request property `vehicleIdTag`
  - the `vehicleId` request property type changed from `string` to `integer`, and format from no format to `int64`
  - the response property `batteryCapacityKwh` became nullable for the status `201`
  - the response property `vehicleId` became nullable for the status `201`
  - …14 more

[Operation history](https://skmtc.dev/monta/apis/monta-partner-api/changes/api/v1/energy/sites/:siteId/vehicles/post.md)

---

[API](https://skmtc.dev/monta/apis/monta-partner-api.md) - [All operations](https://skmtc.dev/monta/apis/monta-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monta/apis/monta-partner-api/revisions/0ca400461c52?raw)