Update Meter

PATCH

meters

{id}

JavaScript

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'], // This is the default and can be omitted
});

const meter = await client.meters.update('mtr_h5tgTWL55OyMO0L2Q9w9v');

console.log(meter.id);

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),  # This is the default and can be omitted
)
meter = client.meters.update(
    id="mtr_h5tgTWL55OyMO0L2Q9w9v",
)
print(meter.id)

package main

import (
	"context"
	"fmt"

	"github.com/dodopayments/dodopayments-go"
	"github.com/dodopayments/dodopayments-go/option"
)

func main() {
	client := dodopayments.NewClient(
		option.WithBearerToken("My Bearer Token"),
	)
	meter, err := client.Meters.Update(
		context.TODO(),
		"mtr_h5tgTWL55OyMO0L2Q9w9v",
		dodopayments.MeterUpdateParams{},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", meter.ID)
}

package com.dodopayments.api.example;

import com.dodopayments.api.client.DodoPaymentsClient;
import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient;
import com.dodopayments.api.models.meters.Meter;
import com.dodopayments.api.models.meters.MeterUpdateParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        DodoPaymentsClient client = DodoPaymentsOkHttpClient.fromEnv();

        Meter meter = client.meters().update("mtr_h5tgTWL55OyMO0L2Q9w9v");
    }
}

package com.dodopayments.api.example

import com.dodopayments.api.client.DodoPaymentsClient
import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient
import com.dodopayments.api.models.meters.Meter
import com.dodopayments.api.models.meters.MeterUpdateParams

fun main() {
    val client: DodoPaymentsClient = DodoPaymentsOkHttpClient.fromEnv()

    val meter: Meter = client.meters().update("mtr_h5tgTWL55OyMO0L2Q9w9v")
}

require "dodopayments"

dodo_payments = Dodopayments::Client.new(
  bearer_token: "My Bearer Token",
  environment: "test_mode" # defaults to "live_mode"
)

meter = dodo_payments.meters.update("mtr_h5tgTWL55OyMO0L2Q9w9v")

puts(meter)

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Dodopayments\Client;
use Dodopayments\Core\Exceptions\APIException;

$client = new Client(
  bearerToken: getenv('DODO_PAYMENTS_API_KEY') ?: 'My Bearer Token',
  environment: 'test_mode',
);

try {
  $meter = $client->meters->update(
    'mtr_h5tgTWL55OyMO0L2Q9w9v',
    description: 'description',
    measurementUnit: 'measurement_unit',
    name: 'name',
  );

  var_dump($meter);
} catch (APIException $e) {
  echo $e->getMessage();
}

using System;
using DodoPayments.Client;
using DodoPayments.Client.Models.Meters;

DodoPaymentsClient client = new();

MeterUpdateParams parameters = new() { ID = "mtr_h5tgTWL55OyMO0L2Q9w9v" };

var meter = await client.Meters.Update(parameters);

Console.WriteLine(meter);

use dodopayments::Client;

#[tokio::main]
async fn main() -> dodopayments::Result<()> {
    let client = Client::from_env()?;
    let id = "id";
    let result = client
        .meters()
        .update()
        .id(id)
        .body(Default::default())
        .await?;
    println!("{result:?}");
    Ok(())
}

curl --request PATCH \
  --url https://test.dodopayments.com/meters/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "<string>",
  "measurement_unit": "<string>",
  "name": "<string>"
}
'

{
  "aggregation": {
    "type": "count",
    "key": "<string>"
  },
  "business_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "event_name": "<string>",
  "id": "<string>",
  "measurement_unit": "<string>",
  "name": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "filter": {
    "clauses": [
      {
        "key": "user_id",
        "operator": "equals",
        "value": "user123"
      },
      {
        "key": "amount",
        "operator": "greater_than",
        "value": 100
      }
    ],
    "conjunction": "and"
  }
}

Authorizations

Authorization

string

header

required

Send your API key as a bearer token: Authorization: Bearer <api_key>. A test mode key starts with dodo_test_, for example dodo_test_AbCd1234EfGh5678.<secret>. A live mode key starts with dodo_live_. Use a test mode key on test.dodopayments.com and a live mode key on live.dodopayments.com. Keys from before these tags have no tag and operate as before.

Path Parameters

string

required

Meter ID

Body

application/json

Fields that do not change how the meter bills. To change event_name, aggregation or filter, archive the meter and create a new meter.

description

string | null

Description of the meter. Send null to remove the description. Omit it to keep it.

measurement_unit

string | null

Measurement unit

name

string | null

Name of the meter

Response

Meter updated

aggregation

Meter Aggregation · object

required

Show child attributes

business_id

string

required

created_at

string<date-time>

required

event_name

string

required

string

required

measurement_unit

string

required

name

string

required

updated_at

string<date-time>

required

description

string | null

filter

null | Meter Filter · object

A filter structure that combines multiple conditions with logical conjunctions (AND/OR).

Supports up to 3 levels of nesting to create complex filter expressions. Each filter has a conjunction (and/or) and clauses that can be either direct conditions or nested filters.

Show child attributes

Example:

{
  "clauses": [
    {
      "key": "user_id",
      "operator": "equals",
      "value": "user123"
    },
    {
      "key": "amount",
      "operator": "greater_than",
      "value": 100
    }
  ],
  "conjunction": "and"
}

Last modified on October 28, 2026

JavaScript

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'], // This is the default and can be omitted
});

const meter = await client.meters.update('mtr_h5tgTWL55OyMO0L2Q9w9v');

console.log(meter.id);

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),  # This is the default and can be omitted
)
meter = client.meters.update(
    id="mtr_h5tgTWL55OyMO0L2Q9w9v",
)
print(meter.id)

package main

import (
	"context"
	"fmt"

	"github.com/dodopayments/dodopayments-go"
	"github.com/dodopayments/dodopayments-go/option"
)

func main() {
	client := dodopayments.NewClient(
		option.WithBearerToken("My Bearer Token"),
	)
	meter, err := client.Meters.Update(
		context.TODO(),
		"mtr_h5tgTWL55OyMO0L2Q9w9v",
		dodopayments.MeterUpdateParams{},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", meter.ID)
}

package com.dodopayments.api.example;

import com.dodopayments.api.client.DodoPaymentsClient;
import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient;
import com.dodopayments.api.models.meters.Meter;
import com.dodopayments.api.models.meters.MeterUpdateParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        DodoPaymentsClient client = DodoPaymentsOkHttpClient.fromEnv();

        Meter meter = client.meters().update("mtr_h5tgTWL55OyMO0L2Q9w9v");
    }
}

package com.dodopayments.api.example

import com.dodopayments.api.client.DodoPaymentsClient
import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient
import com.dodopayments.api.models.meters.Meter
import com.dodopayments.api.models.meters.MeterUpdateParams

fun main() {
    val client: DodoPaymentsClient = DodoPaymentsOkHttpClient.fromEnv()

    val meter: Meter = client.meters().update("mtr_h5tgTWL55OyMO0L2Q9w9v")
}

require "dodopayments"

dodo_payments = Dodopayments::Client.new(
  bearer_token: "My Bearer Token",
  environment: "test_mode" # defaults to "live_mode"
)

meter = dodo_payments.meters.update("mtr_h5tgTWL55OyMO0L2Q9w9v")

puts(meter)

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Dodopayments\Client;
use Dodopayments\Core\Exceptions\APIException;

$client = new Client(
  bearerToken: getenv('DODO_PAYMENTS_API_KEY') ?: 'My Bearer Token',
  environment: 'test_mode',
);

try {
  $meter = $client->meters->update(
    'mtr_h5tgTWL55OyMO0L2Q9w9v',
    description: 'description',
    measurementUnit: 'measurement_unit',
    name: 'name',
  );

  var_dump($meter);
} catch (APIException $e) {
  echo $e->getMessage();
}

using System;
using DodoPayments.Client;
using DodoPayments.Client.Models.Meters;

DodoPaymentsClient client = new();

MeterUpdateParams parameters = new() { ID = "mtr_h5tgTWL55OyMO0L2Q9w9v" };

var meter = await client.Meters.Update(parameters);

Console.WriteLine(meter);

use dodopayments::Client;

#[tokio::main]
async fn main() -> dodopayments::Result<()> {
    let client = Client::from_env()?;
    let id = "id";
    let result = client
        .meters()
        .update()
        .id(id)
        .body(Default::default())
        .await?;
    println!("{result:?}");
    Ok(())
}

curl --request PATCH \
  --url https://test.dodopayments.com/meters/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "<string>",
  "measurement_unit": "<string>",
  "name": "<string>"
}
'

{
  "aggregation": {
    "type": "count",
    "key": "<string>"
  },
  "business_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "event_name": "<string>",
  "id": "<string>",
  "measurement_unit": "<string>",
  "name": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "filter": {
    "clauses": [
      {
        "key": "user_id",
        "operator": "equals",
        "value": "user123"
      },
      {
        "key": "amount",
        "operator": "greater_than",
        "value": 100
      }
    ],
    "conjunction": "and"
  }
}

API Reference

Checkout Sessions

Payments

Subscriptions

Invoices

Discounts

Licenses

Entitlements

Customers

Customer Wallets

Customer Blocklist

Products

Localized Pricing

Addons

Credit Entitlements

Meters

Usage Events

Refunds

Disputes

Payouts

Balance Ledger

Moderation

Brands

Webhooks

Miscellaneous

Product Collections

Authorizations

Path Parameters

Body

Response