---
title: "Create new meter"
method: POST
path: "/meters"
tags: ["Meters"]
---

# Create new meter

`POST /meters`

Endpoint used to create a new meter. Pay attention to the `measurementType` field as it has a significant impact on the behavior of your meter.

## Query parameters

- `skipWebhook` boolean

## Headers

- `x-organization-id` integer

## Request body

- object
  - `name` string, required — Name of the meters
  - `description` string, nullable — Description of the meter
  - `measurementType` 'MANUAL' | 'IOT_DEVICE' | 'AUTOMATED_SENSOR' — Represents the Type of meter. <br><br><code>Manual</code>: They are made to be used in the MaintainX app and to retain manually entered values and are limited to 10 distinct readings creation requests per 24 hours over REST API. Batched readings requests only count as one toward the rate limit. <br><br><code>Automated</code>: (Enterprise Plan) Automated meters store high frequency readings sent from integrations and have normal rate limiting. <br><br>~~<code>IoT Device</code>~~: IoT Device meters are deprecated and should no longer be used in the future. Creating an IoT Device meter will mimic automated meters in terms of behavior to avoid breaking changes.
  - `readingFrequency` union — Expected reading frequency of the meter. Mostly useful for manual meters.
    - object, nullable
      - `type` 'SECONDLY', required
      - `interval` integer — Number of seconds between readings. Minimum 10s for IOT_DEVICE, 86400s for MANUAL
    - object, nullable
      - `type` 'MINUTLY', required
      - `interval` integer — Number of minutes between readings
    - object, nullable
      - `type` 'HOURLY', required
      - `interval` integer — Number of hours between readings
    - object, nullable
      - `type` 'DAILY', required
      - `interval` integer — Number of days between readings
    - object, nullable
      - `type` 'WEEKLY', required
      - `interval` integer — Number of weeks between readings
      - `days` string[] — Days of the week the event will occur
    - object, nullable
      - `type` 'MONTHLY', required
      - `interval` integer — Number of months between readings
      - `day` integer — Day of the month the event will occur
    - object, nullable
      - `type` 'YEARLY', required
      - `interval` integer — Number of years between readings
  - `unit` string, required — Measurement unit for the readings. Any string is accepted. However, if applicable, we recommed you to use the following units as it may carry extra functionality: <br><ul> <li>Distance: <ul> <li><code>Miles</code></li><li><code>Feet</code></li><li><code>Inches</code></li><li><code>Kilometers</code></li><li><code>Meters</code></li><li><code>Centimeters</code></li><li><code>Millimeters</code></li> </ul> </li> <li>Volume: <ul> <li><code>Gallons</code></li><li><code>Liters</code></li><li><code>Milliliters</code></li><li><code>Cubic Meters</code></li> </ul> </li> <li>Temperature: <ul> <li><code>Celsius</code></li><li><code>Fahrenheit</code></li><li><code>Kelvin</code></li> </ul> </li> <li>Other: <ul> <li><code>Hours</code></li><li><code>Cycles</code></li><li><code>PSI</code></li><li><code>Kilograms</code></li><li><code>Grams</code></li><li><code>dBm</code></li><li><code>Nm</code></li> </ul> </li> <li>Velocity: <ul> <li><code>MetersPerSecond</code></li><li><code>InchesPerSecond</code></li><li><code>MillimetersPerSecond</code></li> </ul> </li> <li>Acceleration: <ul> <li><code>G-Force</code></li><li><code>MetersPerSecondSquared</code></li><li><code>FeetPerSecondSquared</code></li> </ul> </li> <li>Electrical: <ul> <li><code>Volts</code></li><li><code>Amps</code></li> </ul> </li> </ul>
  - `assetId` integer, nullable — Global ID of the asset tied to the meter
  - `locationId` integer, nullable — Global ID of the location tied to the meter

## Response `201`

Successfully created meter

- object
  - `id` number, required — Global ID of the meter.

## Other responses

- `400` — OrganizationId was not provided
- `401` — Invalid token
- `502` — The creation of the resource failed on the upstream service.

---

[API](https://skmtc.net/getmaintainx/apis/maintainx-api.md) · [All operations](https://skmtc.net/getmaintainx/apis/maintainx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getmaintainx/maintainx-api/revisions/ef9153fcac7c/schema)