Create a Customer

POST {{url}}/customers

Please consider using the Billing Requests API instead of Customers for any future integrations.

Creates a new customer object.

Note: the region field should be uncommented for US customer addresses.

Create a customer API Docs

Request Body

{"customers"=>{"email"=>"{{$randomExampleEmail}}", "given_name"=>"{{$randomFirstName}}", "family_name"=>"{{$randomLastName}}", "address_line1"=>"{{$randomStreetAddress}}", "city"=>"{{$randomCity}}", "postal_code"=>"E8 3GX", "country_code"=>"GB", "metadata"=>{"crm_id"=>"ABCD{{$randomInt}}"}}}

HEADERS

KeyDatatypeRequiredDescription
Idempotency-Keynumber

RESPONSES

status: Created

{"customers":{"id":"CU0014DQP7YPKP","created_at":"2024-03-22T20:42:11.311Z","email":"gregory93@example.net","given_name":"Bridie","family_name":"Altenwerth","company_name":null,"address_line1":"61188 Godfrey Ports","address_line2":null,"address_line3":null,"city":"Swaniawskitown","region":null,"postal_code":"E8 3GX","country_code":"GB","language":"en","swedish_identity_number":null,"danish_identity_number":null,"phone_number":null,"metadata":{"crm_id":"ABCD769"}}}