---
title: "Create meter"
method: POST
path: "/v1/meter/create"
tags: ["Meters"]
---

# Create meter

`POST /v1/meter/create`

Create a new meter for a site. Requires admin permissions.

## Request body

- object
  - `siteId` integer, required — ID of the site to add the meter to
  - `mpxn` string, required — MPAN (13 digits for electricity) or MPRN (6-10 digits for gas)
  - `utilityType` 'ELECTRICITY' | 'GAS' | 'BMS', required — Type of utility

## Response `200`

Meter created successfully

- Meter
  - `id` string — Meter identifier
  - `siteId` string — Associated site identifier
  - `mpxn` string — MPAN (13 digits for electricity) or MPRN (6-10 digits for gas)
  - `utilityType` 'ELECTRICITY' | 'GAS' | 'BMS' — Type of utility
  - `meterSerialNumber` string — Meter serial number
  - `supplier` string — Energy supplier name
  - `status` 'ACTIVE' | 'INACTIVE' — Meter status
  - `createdAt` string, date-time — Creation timestamp

## Other responses

- `4XX` — Client error response

## Changes

- **2025-12-09** `d899129585db` — 4 breaking
  - the response property `id` became optional for the status `200`
  - the response property `mpxn` became optional for the status `200`
  - the response property `siteId` became optional for the status `200`
  - the response property `utilityType` became optional for the status `200`
- **2025-12-02** `341d0d8f51f9` — 1 info
  - endpoint added
- **2025-11-17** `1ecbbc9bbafb` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/voltview/apis/voltview-api/changes/v1/meter/create/post.md)

---

[API](https://skmtc.dev/voltview/apis/voltview-api.md) · [All operations](https://skmtc.dev/voltview/apis/voltview-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/voltview/voltview-api/revisions/d90c739b55df/schema)