---
title: "Record a meter event"
method: POST
path: "/v1/sdk/meter-events"
tags: ["Meter Events"]
---

# Record a meter event

`POST /v1/sdk/meter-events`

Records a single usage event against a named meter. When the customer is on a metered plan, credits are also debited for the event (the debit is not surfaced in the response).

## Request body

- RecordMeterEventZodDto
  - `customerRef` string, required
  - `meterName` string, required
  - `productRef` string
  - `properties` object
  - `timestamp` string
  - `value` number

## Response `200`

Event recorded

- object
  - `success` boolean

## Other responses

- `400` — Invalid meter name or meter is archived
- `404` — Customer not found

## Changes

- **2026-07-30** `8578b7536a9f` — 1 info
  - the request property `properties` became optional
- **2026-07-17** `bbc2ff2bc849` — 2 warning
  - the `customerRef` request property's maxLength was set to `20`
  - the `productRef` request property's maxLength was set to `20`
- **2026-07-04** `a30b6aef464d` — 3 info
  - the endpoint scheme security `SecretKey` was added to the API
  - the endpoint scheme security `bearer` was removed from the API
  - added the non-success response with the status `404`
- **2026-04-08** `052cc028fdfa` — 1 breaking, 2 warning
  - added the new required request property `customerRef`
  - removed the request property `customerId`
  - removed the request property `productId`
- **2026-04-07** `d69c95d790d2` — 1 warning, 1 info
  - removed the request property `productReference`
  - added the new optional request property `productRef`

[Full history](https://skmtc.dev/solvapay/apis/solvapay-rest-api/changes/v1/sdk/meter-events/post.md)

---

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