---
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}`

## Request

- Base URL: `https://apisandbox.dev.clover.com`
- URL: `https://apisandbox.dev.clover.com/v3/apps/{appId}/merchants/{mId}/metereds/{meteredId}`
- Auth: HTTP bearer

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.dev/clover/apis/platform-api.md) - [All operations](https://skmtc.dev/clover/apis/platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clover/apis/platform-api/revisions/95fd9ec401ef?raw)