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"=>"<string>", "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[validate_location]", "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: Created
{"id":"cus_NffrFeUfNV2Hib","object":"customer","address":null,"balance":0,"created":1680893993,"currency":null,"default_source":null,"delinquent":false,"description":null,"discount":null,"email":"jennyrosen@example.com","invoice_prefix":"0759376C","invoice_settings":{"custom_fields":null,"default_payment_method":null,"footer":null,"rendering_options":null},"livemode":false,"metadata":{},"name":"Jenny Rosen","next_invoice_sequence":1,"phone":null,"preferred_locales":[],"shipping":null,"tax_exempt":"none","test_clock":null}