Skip to main content
POST
Create business metric

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Scopes

write

Grants write access

Body

application/json

Create a new BusinessMetric.

title
string
required

The title of the BusinessMetrics.

cost_report_tokens_with_metadata
object[]

The tokens for any CostReports that use the BusinessMetric, the unit scale, and label filter.

values
object[]

The dates, amounts, and (optional) labels for the BusinessMetric.

forecasted_values
object[]

The dates, amounts, and (optional) labels for forecasted BusinessMetric values.

datadog_metric_fields
object

Datadog metric configuration fields

cloudwatch_fields
object

Cloudwatch configuration fields.

gcp_bigquery_metric_fields
object

GCP BigQuery metric configuration fields.

snowflake_metric_fields
object

Snowflake metric configuration fields.

metronome_metric_fields
object

Metronome configuration. Customer ID, customer name, first ingest alias, and supported custom fields are imported automatically as label columns. Omitted fields preserve existing values on update. Switching to revenue clears billable metric fields.

clickhouse_metric_fields
object

ClickHouse metric configuration fields.

Response

BusinessMetric model

token
string
required

The token of the BusinessMetric.

Example:

"bsnss_mtrc_1234"

title
string
required

The title of the BusinessMetric.

Example:

"Total Revenue"

cost_report_tokens_with_metadata
object[]
required

The tokens for any CostReports that use the BusinessMetric, the unit scale, and label filter.

import_type
enum<string> | null
required

The type of import for the BusinessMetric.

Available options:
datadog_metrics,
cloudwatch,
clickhouse_metrics,
gcp_bigquery_metrics,
snowflake_metrics,
metronome_metrics,
rippling_metrics,
csv
Example:

"datadog_metrics"

integration_token
string | null
required

The Integration token used to import the BusinessMetric.

created_by_token
string | null

The token of the Creator of the BusinessMetric.

Example:

"usr_1234"

cloudwatch_fields
object
datadog_metric_fields
object
gcp_bigquery_metric_fields
object
snowflake_metric_fields
object
metronome_metric_fields
object
clickhouse_metric_fields
object