---
title: "Create an app billing metered event"
method: POST
path: "/v3/apps/{appId}/merchants/{mId}/metereds/{meteredId}"
tags: ["APPS"]
---

# Create an app billing metered event

`POST /v3/apps/{appId}/merchants/{mId}/metereds/{meteredId}`

Creates an app billing metered event. Clover charges the merchant for each action they take on the app based on the amount specified on the app's [Pricing & Distribution](https://docs.clover.com/docs/configuring-billing#subscription-pricing) page. Pass `count` as a query parameter to bill the merchant for the number of metered events. `count` is ignored if you pass it in the request body. Otherwise, `count` defaults to 1. Requires an OAuth-generated token. See [Set up pricing tiers](https://docs.clover.com/docs/configuring-billing#metered-pricing).

## Path parameters

- `appId` string, required
- `mId` string, required
- `meteredId` string, required

## Headers

- `User-Agent` string, required

## Response `200`

- object
  - `id` string
  - `appMetered` object, required
    - `id` string — Unique identifier
    - `amount` integer — DEPRECATED: App metered amount. Instead use per country pricing in meteredCountries
    - `action` string — DEPRECATED: App metered action. Instead use per country pricing in meteredCountries
    - `active` boolean — DEPRECATED: App metered active status. Instead use per country pricing in meteredCountries
    - `meteredCountries` object[] — Metered country options for this app metered
      - `id` string — Unique identifier
      - `action` string, required — App metered action
      - `amount` integer, required — The cost of the metered country
      - `country` string, required — The country of the metered country
      - `active` boolean — App metered country active status
      - `appMetered` object — Reference to metered this metered country belongs to
        - `id` string — Unique identifier.
      - `locales` object[] — List of locale specific metered country resources.
        - `id` string — Unique identifier.
    - `app` object — Reference to the app this metered belongs to
      - `id` string — Unique identifier.
    - `label` string — A label used to identify this metered action
  - `count` integer, required
  - `createdTime` integer
  - `modifiedTime` integer
  - `charge` object
    - `id` string — Unique identifier.

---

[API](https://skmtc.net/clover/apis/platform-api.md) · [All operations](https://skmtc.net/clover/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clover/platform-api/versions/08da265101a3/schema)