Bulk Create

this api endpoint (post) (post) creates multple customers permissions customers create webhook event customer events docid\ vpxf3upxl n7gflcvvism body parameters customers array of objects an array containing objects each representing a customer that you want to create the maximum amount of objects in the array is 500 if the request is successful, the creation of your customers will be scheduled and executed at a later stage usually this might be a few minutes, however it depends on the server load at the time of the request once the import has been completed, a notification will be dispatched to your account the parameters for each object in the array are the same as the create customer docid\ cuemhngxn3hftqavvmmtb endpoint and include the following name string the customer's first name email string the customer's email address country string ( appendix docid\ kfbmx4q3dxjtduqf75yx1 ) a two letter country code (iso 3166) representing the customer's country last name string the customer's last name locale string ( appendix docid\ kfbmx4q3dxjtduqf75yx1 ) the customer's language the default is english en timezone offset string the utc timezone offset for this customer example +03 00 phone string the customer's primary phone number billing information object billing details are optional but recommended as they might be crucial for accounting and tax purposes "billing information" { "phone" "08421234", "name" "james doe" "representative" "representative doe", "email" "john doe\@tamio com", "address" "my street", "city" "frankfrt", "postcode" "abc1234", "country" "de", "locale" "en", "vat" "de1234567", "is company" true } phone string the customer's billing phone name string the customer's billing name or company representative string the name of the contact person for this address is company boolean this attribute shows whether this address belongs to a business or an individual the default value is false email string the customer's billing email address string the customer's address city string the customer's city postcode string the customer's postcode state string ( appendix docid\ kfbmx4q3dxjtduqf75yx1 ) the customer's state (if supported) country string ( appendix docid\ kfbmx4q3dxjtduqf75yx1 ) the customer's billing country in iso 3166 format vat number string the customer's vat number (if supported) locale string ( appendix docid\ kfbmx4q3dxjtduqf75yx1 ) the preferred language of the representative for this address shipping information object the shipping details are optional however it is recommended to collect them as soon as possible if you are planning to sell physical goods to this customer "shipping information" { "phone" "08421234", "name" "james doe" "email" "john doe\@tamio com", "address" "my street", "city" "frankfrt", "postcode" "abc1234", "country" "de", "locale" "en" } phone string the customer's billing phone name string the customer's billing name or company email string the customer's billing email address string the customer's address city string the customer's city postcode string the customer's postcode state string ( appendix docid\ kfbmx4q3dxjtduqf75yx1 ) the customer's state (if supported) country string ( appendix docid\ kfbmx4q3dxjtduqf75yx1 ) the customer's billing country in iso 3166 format locale string ( appendix docid\ kfbmx4q3dxjtduqf75yx1 ) the preferred language of the representative for this address same shipping address boolean the shipping address will be generated from the customer's billing information if set to true require "uri" require "json" require "net/http" url = uri("https //api tamio com/v2/customers/bulk/create") https = net http new(url host, url port) https use ssl = true request = net http post new(url) request\["accept"] = "application/json" request\["authorization"] = "bearer your token here" data = { customers \[ { name 'john', last name 'doe', country 'de', email 'john doe\@tamio com' } ] } request body = data to json response = https request(request) puts response read bodycurl location request post 'https //api tamio com/v2/customers/bulk/create' \\ \ header 'accept application/json' \\ \ header 'authorization bearer your token here' \\ \ data raw '{"customers" \[{"name" "john","country" "de","email" "john doe\@plugnpaid com","last name" "doe"}]}'var myheaders = new headers(); myheaders append("accept", "application/json"); myheaders append("authorization", "bearer your token here"); var data = { customers \[ { name 'john', last name 'doe', country 'de', email 'john doe\@tamio com' } ] }; var body = json stringify(data); var requestoptions = { method 'post', headers myheaders, body body }; fetch("https //api tamio com/v2/customers/bulk/create", requestoptions) then(response => response text()) then(result => console log(result)) catch(error => console log('error', error));{ "status" 200 }