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, Stripe, or custom.
To create a customer in the Metronome app:
- Click Customers.
- On the Customers page, click Add new customer.
- In the resulting form, provide the customer's name and one or more ingest aliases (optional).
- 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 https://api.metronome.com/v1/customers \
-H "Authorization: Bearer <TOKEN>" \
-H "Content-Type: application/json" \
-d '{
"external_id": "team@example.com",
"name": "Example, Inc."
}'
You can configure the customer's billing when creating the customer or by POSTing to /customers/{customer_id}/updateConfig.
See the Salesforce integration documentation to generate quotes for customers as part of the Configure, Price, Quote (CPQ) process.