Skip to main content

Create customers

Create customers in Metronome so you can assign a plan to them in preparation for invoicing. Customers can be created using the Metronome app or API, using the /customers endpoint.

The customer name is required. This should be descriptive and human-readable. (Metronome generates a unique, internal ID for each customer.)

You can optionally provide one or more ingest_aliases for your usage events.

Finally, you can configure the customer's billing: AWS Marketplace, NetSuite, Stripe, or custom.

To create a customer in the Metronome app:

  1. Click Customers.
  2. On the Customers page, click Add new customer.
  3. In the resulting form, provide the customer's name and one or more ingest aliases (optional).
  4. Click Add new customer.

Once created, you can configure the customer's billing using the Settings pane of the customer's detail view.

For the API, make a POST request to /customers.

curl \
-H "Authorization: Bearer {{TOKEN}}" \
-H "Content-Type: application/json" \
-d '{
"external_id": "",
"name": "Example, Inc."

You can configure the customer's billing when creating the customer or by POSTing to /customers/{customer_id}/updateConfig.

Create customers and quotes through Salesforce

See the Salesforce integration documentation to generate quotes for customers as part of the Configure, Price, Quote (CPQ) process.

Metronome logoMetronome logo