## Create

`v1.customers.create(**kwargs) -> CustomerCreateResponse`

**post** `/v1/customers`

Create a new customer

### Parameters

- **name:** `String`

  This will be truncated to 160 characters if the provided name is longer.

- **billing\_config:** `{ billing_provider_customer_id, billing_provider_type, aws_is_subscription_product, 3 more}`

  - **billing\_provider\_customer\_id:** `String`

  - **billing\_provider\_type:** `:aws_marketplace | :stripe | :netsuite | 5 more`

    - `:aws_marketplace`

    - `:stripe`

    - `:netsuite`

    - `:custom`

    - `:azure_marketplace`

    - `:quickbooks_online`

    - `:workday`

    - `:gcp_marketplace`

  - **aws\_is\_subscription\_product:** `bool`

    True if the aws_product_code is a SAAS subscription product, false otherwise.

  - **aws\_product\_code:** `String`

  - **aws\_region:** `:"af-south-1" | :"ap-east-1" | :"ap-northeast-1" | 22 more`

    - `:"af-south-1"`

    - `:"ap-east-1"`

    - `:"ap-northeast-1"`

    - `:"ap-northeast-2"`

    - `:"ap-northeast-3"`

    - `:"ap-south-1"`

    - `:"ap-southeast-1"`

    - `:"ap-southeast-2"`

    - `:"ca-central-1"`

    - `:"cn-north-1"`

    - `:"cn-northwest-1"`

    - `:"eu-central-1"`

    - `:"eu-north-1"`

    - `:"eu-south-1"`

    - `:"eu-west-1"`

    - `:"eu-west-2"`

    - `:"eu-west-3"`

    - `:"me-south-1"`

    - `:"sa-east-1"`

    - `:"us-east-1"`

    - `:"us-east-2"`

    - `:"us-gov-east-1"`

    - `:"us-gov-west-1"`

    - `:"us-west-1"`

    - `:"us-west-2"`

  - **stripe\_collection\_method:** `:charge_automatically | :send_invoice`

    - `:charge_automatically`

    - `:send_invoice`

- **custom\_fields:** `Hash[Symbol, String]`

- **customer\_billing\_provider\_configurations:** `Array[{ billing_provider, configuration, delivery_method, delivery_method_id}]`

  - **billing\_provider:** `:aws_marketplace | :azure_marketplace | :gcp_marketplace | 2 more`

    The billing provider set for this configuration.

    - `:aws_marketplace`

    - `:azure_marketplace`

    - `:gcp_marketplace`

    - `:stripe`

    - `:netsuite`

  - **configuration:** `Hash[Symbol, untyped]`

    Configuration for the billing provider. The structure of this object is specific to the billing provider and delivery provider combination. Defaults to an empty object, however, for most billing provider + delivery method combinations, it will not be a valid configuration.

  - **delivery\_method:** `:direct_to_billing_provider | :aws_sqs | :tackle | :aws_sns`

    The method to use for delivering invoices to this customer. If not provided, the `delivery_method_id` must be provided.

    - `:direct_to_billing_provider`

    - `:aws_sqs`

    - `:tackle`

    - `:aws_sns`

  - **delivery\_method\_id:** `String`

    ID of the delivery method to use for this customer. If not provided, the `delivery_method` must be provided.

- **external\_id:** `String`

  (deprecated, use ingest_aliases instead) an alias that can be used to refer to this customer in usage events

- **ingest\_aliases:** `Array[String]`

  Aliases that can be used to refer to this customer in usage events

### Returns

- `class CustomerCreateResponse`

  - **data:** `Customer`

### Example

```ruby
require "metronome_sdk"

metronome = MetronomeSDK::Client.new(bearer_token: "My Bearer Token")

customer = metronome.v1.customers.create(name: "Example, Inc.")

puts(customer)
```