Creating Customers

Registering customers with Octane.


General Usage: Programmatic

Customers are at the core of your business and the Octane model.


Defining a customer is simple, requiring only a name and optional metadata.


import octane
octane.api_key = "<YOUR_API_KEY>"

  display_name="Customer 1",
    "email": "[email protected]",
    "url": "",
    "address_line_1": "111 Main St",
    "address_line_2": "#1",
    "city": "New York",
    "state": "NY",
    "country": "United States",
    "zipcode": "10011"
import Octane from "octane-node";
const octane = new Octane("<YOUR_API_KEY>");

  name: "customer_1",
  displayName: "Customer 1",
  contactInfo: {
    email: "[email protected]",
    url: "",
    addressLine1: "111 Main St",
    addressLine2: "#1",
    city: "New York",
    state: "NY",
    country: "United States",
    zipcode: "10011"
package main

import ""

func main() {
  client := octane.NewClient("<YOUR_API_KEY>")
  args := octane.CreateCustomerArgs{
    Name:        "customer_1",
    DisplayName: "Customer 1",
    ContactInfo: &octane.ContactInfoInputArgs{
      Email:        "[email protected]",
      Url:          "",
      AddressLine1: "111 Main St",
      AddressLine2: "#1",
      City:         "New York",
      State:        "NY",
      Country:      "United States",
      Zipcode:      "10011",
  _, _, err := client.Customers.Create(args)
  if err != nil {

By default, Measurements are associated with customers using the customer_name field on the measurement.
For advancement mappings, we recommend using the Measurement Mappings field on the customer object and setting the appropriate labels on the measurement.


Field NameDescriptionTypeRequired
nameThe customer identifier. Must be unique. Should be a dev-friendly string. *NOTE: This is known as 'ID' in the portalStringRequired
display_nameThe name to display in UI. Defaults to name. NOTE: This is known as 'Name' in the portalStringOptional
descriptionA description of the customer. Defaults to null.StringOptional
emailAn email for the customer. Defaults to null.StringOptional
urlA url for company website. Defaults to null.StringOptional
address_line_1Customer's address line 1. Defaults to null.StringOptional
address_line_2Customer's address line 2. Defaults to null.StringOptional
cityCustomer's city. Defaults to null.StringOptional
stateCustomer's state. Defaults to null.StringOptional
countryCustomer's country. Defaults to null.StringOptional
zipcodeCustomer's zipcode. Defaults to null.StringOptional
measurement_mappingsA set of measurement labels and corresponding value regexes to match measurements (see Measurement Mappings). These will apply to measurements for all meters. Defaults to null.Dict[String, String]Optional
price_plan_nameA price plan to subscribe the customer to (see Subscriptions). Defaults to null.StringOptional