Create a customer
POST {{baseUrl}}/v1/customers
Creates a new customer object.
Request Body
[{"name"=>"address[city]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"address[country]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"address[line1]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"address[line2]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"address[postal_code]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"address[state]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"balance", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"cash_balance[settings][reconciliation_mode]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"coupon", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"description", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"email", "value"=>"{{email}}", "datatype"=>"string"}, {"name"=>"expand[0]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"expand[1]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"invoice_prefix", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"invoice_settings[custom_fields][0][name]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"invoice_settings[custom_fields][0][value]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"invoice_settings[custom_fields][1][name]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"invoice_settings[custom_fields][1][value]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"invoice_settings[default_payment_method]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"invoice_settings[footer]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"invoice_settings[rendering_options][amount_tax_display]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"name", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"next_invoice_sequence", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"payment_method", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"phone", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"preferred_locales[0]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"preferred_locales[1]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"promotion_code", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"shipping[address][city]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"shipping[address][country]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"shipping[address][line1]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"shipping[address][line2]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"shipping[address][postal_code]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"shipping[address][state]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"shipping[name]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"shipping[phone]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"source", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"tax[ip_address]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"tax_exempt", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"tax_id_data[0][type]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"tax_id_data[0][value]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"tax_id_data[1][type]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"tax_id_data[1][value]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"test_clock", "value"=>"<string>", "datatype"=>"string"}]
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string |
RESPONSES
status: OK
{"id":"cus_NKPbPxZOeEhHO1","object":"customer","address":null,"balance":0,"created":1675990078,"currency":null,"default_source":null,"delinquent":false,"description":null,"discount":null,"email":"lenny@example.com","invoice_prefix":"326ECDAF","invoice_settings":{"custom_fields":null,"default_payment_method":null,"footer":null,"rendering_options":null},"livemode":false,"metadata":{},"name":null,"next_invoice_sequence":1,"phone":null,"preferred_locales":[],"shipping":null,"tax_exempt":"none","test_clock":null}