Metronome

Overview

Metronome is a billing platform that powers usage-based pricing. SaddleData provides a bidirectional integration with Metronome:

• Destination: Send usage events and billing metrics from your data warehouse or application database directly to Metronome's Ingest API.
• Source: Extract customers, invoices, and billable metrics from Metronome to your data warehouse for analysis and auditing.

Prerequisites

To connect to Metronome, you will need:

• A Metronome API Token with appropriate permissions (Ingest permissions for destination, Read permissions for source).

Configuration

When creating a Metronome Integration, simply provide your:

• API Key: Your secret Metronome API token.

Capabilities

Metronome as a Source

SaddleData can extract the following entities from Metronome:

• Customers: List of all customers and their metadata.
• Invoices: Billing invoices with status, totals, and timestamps.
• Billable Metrics: Definitions of billable metrics.

Sync Modes:

• Full Refresh: Re-syncs the entire dataset.
• Incremental: Fetches new records using API cursors.

Metronome as a Destination

SaddleData can stream usage events to Metronome for billing calculation.

• Target Entity: usage_events (or configured table name).
• Sync Modes:
  • Incremental Append: The recommended mode for sending usage events. SaddleData batches events and sends them to the /v1/ingest endpoint.
• Requirements:
  • The source data must contain a customer_id and a timestamp field.
  • Other fields will be mapped as properties in the Metronome event payload.

Declarative Configuration

apiVersion: v1
kind: Connection
metadata:
  name: metronome-connection
spec:
  connectorId: metronome
  integrationId: metronome-integration-id
  configuration:
    capability: destination