Create billable metrics

To add a new billable metric through the user interface:

• Enter its name;
• Assign it a code which will be used as the name of the event sent from your backend;
• Add a description (optional);
• Select the aggregation type which will define how consumption will be measured;
• Define the aggregation property field_name to aggregate on;
• Define groups if you price several dimensions for a same billing component; and
• Define if this billable metric is recurring and kept in memory period over period, or resume to 0 at the end of each period.

Here are few examples of billable metrics you can create:

LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"

curl --location --request POST "$LAGO_URL/api/v1/billable_metrics" \
  --header "Authorization: Bearer $API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "billable_metric": {
      "name": "Storage",
      "code": "storage",
      "description": "Number of GB used",
      "aggregation_type": "sum_agg",
      "field_name": "gb",
      "recurring": false,
      "group": {
        "key": "provider",
        "value": ["aws", "google", "azure"]
      }
    }
  }'