Legacy (v0)
Create a customer
Creates a customer for the company. email is required and must be unique within the company, as must account_id when supplied; a duplicate returns 422 with the existing customer under errors.existing_customer; when customer-create echo protection is enabled, callers without the members.view permission never receive errors.existing_customer and also get this 422 when the email belongs to an existing member. An optional default address, notes, metadata and metafields are saved with the customer. An optional dob is saved only when this request creates the user account, because the account and its date of birth are shared across companies; an existing account’s date of birth is not changed. Requires a company admin Bearer token with permission to manage members. When the member write-target rollout is enabled, the response created_at is the creation time of the newly created member record, or of the new customer record when an existing member without a customer is reused; until then it is the customer record’s.
POST
/
api
/
customers
Create a customer
curl --request POST \
--url https://api.fluid.app/api/customers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"email": "robert.california@sabre.com",
"first_name": "Robert",
"last_name": "California",
"phone": "+15705550199",
"dob": "1974-03-25",
"external_id": "crm-00048377",
"notes": "Bulk buyer for the Tallahassee office.",
"metadata": {
"referral_source": "sales-call"
},
"default_address_attributes": {
"name": "Robert California",
"address1": "1725 Slough Avenue",
"address2": "Suite 200",
"city": "Scranton",
"state": "PA",
"postal_code": "18505",
"country_code": "US"
}
}
'import requests
url = "https://api.fluid.app/api/customers"
payload = {
"email": "robert.california@sabre.com",
"first_name": "Robert",
"last_name": "California",
"phone": "+15705550199",
"dob": "1974-03-25",
"external_id": "crm-00048377",
"notes": "Bulk buyer for the Tallahassee office.",
"metadata": { "referral_source": "sales-call" },
"default_address_attributes": {
"name": "Robert California",
"address1": "1725 Slough Avenue",
"address2": "Suite 200",
"city": "Scranton",
"state": "PA",
"postal_code": "18505",
"country_code": "US"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
email: 'robert.california@sabre.com',
first_name: 'Robert',
last_name: 'California',
phone: '+15705550199',
dob: '1974-03-25',
external_id: 'crm-00048377',
notes: 'Bulk buyer for the Tallahassee office.',
metadata: {referral_source: 'sales-call'},
default_address_attributes: {
name: 'Robert California',
address1: '1725 Slough Avenue',
address2: 'Suite 200',
city: 'Scranton',
state: 'PA',
postal_code: '18505',
country_code: 'US'
}
})
};
fetch('https://api.fluid.app/api/customers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/customers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'email' => 'robert.california@sabre.com',
'first_name' => 'Robert',
'last_name' => 'California',
'phone' => '+15705550199',
'dob' => '1974-03-25',
'external_id' => 'crm-00048377',
'notes' => 'Bulk buyer for the Tallahassee office.',
'metadata' => [
'referral_source' => 'sales-call'
],
'default_address_attributes' => [
'name' => 'Robert California',
'address1' => '1725 Slough Avenue',
'address2' => 'Suite 200',
'city' => 'Scranton',
'state' => 'PA',
'postal_code' => '18505',
'country_code' => 'US'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/customers"
payload := strings.NewReader("{\n \"email\": \"robert.california@sabre.com\",\n \"first_name\": \"Robert\",\n \"last_name\": \"California\",\n \"phone\": \"+15705550199\",\n \"dob\": \"1974-03-25\",\n \"external_id\": \"crm-00048377\",\n \"notes\": \"Bulk buyer for the Tallahassee office.\",\n \"metadata\": {\n \"referral_source\": \"sales-call\"\n },\n \"default_address_attributes\": {\n \"name\": \"Robert California\",\n \"address1\": \"1725 Slough Avenue\",\n \"address2\": \"Suite 200\",\n \"city\": \"Scranton\",\n \"state\": \"PA\",\n \"postal_code\": \"18505\",\n \"country_code\": \"US\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fluid.app/api/customers")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"email\": \"robert.california@sabre.com\",\n \"first_name\": \"Robert\",\n \"last_name\": \"California\",\n \"phone\": \"+15705550199\",\n \"dob\": \"1974-03-25\",\n \"external_id\": \"crm-00048377\",\n \"notes\": \"Bulk buyer for the Tallahassee office.\",\n \"metadata\": {\n \"referral_source\": \"sales-call\"\n },\n \"default_address_attributes\": {\n \"name\": \"Robert California\",\n \"address1\": \"1725 Slough Avenue\",\n \"address2\": \"Suite 200\",\n \"city\": \"Scranton\",\n \"state\": \"PA\",\n \"postal_code\": \"18505\",\n \"country_code\": \"US\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/customers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"email\": \"robert.california@sabre.com\",\n \"first_name\": \"Robert\",\n \"last_name\": \"California\",\n \"phone\": \"+15705550199\",\n \"dob\": \"1974-03-25\",\n \"external_id\": \"crm-00048377\",\n \"notes\": \"Bulk buyer for the Tallahassee office.\",\n \"metadata\": {\n \"referral_source\": \"sales-call\"\n },\n \"default_address_attributes\": {\n \"name\": \"Robert California\",\n \"address1\": \"1725 Slough Avenue\",\n \"address2\": \"Suite 200\",\n \"city\": \"Scranton\",\n \"state\": \"PA\",\n \"postal_code\": \"18505\",\n \"country_code\": \"US\"\n }\n}"
response = http.request(request)
puts response.read_body{
"customer": {
"id": 48377,
"full_name": "Robert California",
"email": "robert.california@sabre.com",
"created_at": "2026-09-30T15:42:06Z",
"user_company_id": 90611,
"metadata": {
"referral_source": "sales-call"
},
"email_marketing": false,
"sms_marketing": false,
"account_id": "DM-CUST-48377",
"phone": "+15705550199",
"external_id": "crm-00048377",
"first_name": "Robert",
"last_name": "California",
"verified_email": false,
"orders_count": 0,
"display_total_spent": "$0.00",
"name": "Robert California",
"role": "customer",
"last_order_id": null,
"notes": "Bulk buyer for the Tallahassee office.",
"active": true,
"total_spent": "0.0",
"customer_notes": [],
"default_address": {
"id": 331402,
"name": "Robert California",
"address1": "1725 Slough Avenue",
"address2": "Suite 200",
"address3": null,
"city": "Scranton",
"state": "PA",
"subdivision_code": "PA",
"postal_code": "18505",
"country_code": "US",
"phone": null,
"country_num_code": 840,
"default": true
},
"addresses": [
{
"id": 331402,
"name": "Robert California",
"address1": "1725 Slough Avenue",
"address2": "Suite 200",
"address3": null,
"city": "Scranton",
"state": "PA",
"subdivision_code": "PA",
"postal_code": "18505",
"country_code": "US",
"phone": null,
"country_num_code": 840,
"default": true
}
],
"payment_methods": [],
"is_rep": false,
"is_discarded": false,
"tax_exempt": false,
"sales_tax_id": null,
"active_subscriptions_count": 0,
"inactive_subscriptions_count": 0,
"metafields": [],
"member_id": "019f93c7-5e20-7a4b-b1d8-3c7e0f2a9d64",
"jwt": ""
},
"meta": {
"request_id": "c4b1e8f2-3a7d-4e19-9b62-5d0f7a2c8e41",
"timestamp": "2026-09-30T15:42:07Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"code": "<string>",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30",
"payment_uuid": "<string>",
"error_details": [
{
"code": "<string>",
"field": "<string>",
"payment": "not_attempted",
"message": "<string>"
}
],
"coded_recovery": true
}
}Body
application/json
Request payload
Response
Created
A single customer.
A customer of the company. Every customer response carries the base fields. Some fields appear only on particular endpoints: active_subscriptions_count, inactive_subscriptions_count, metafields, member_id and jwt are added for company admins; points and attributable_rep are added by the detail, update and attributable-rep endpoints; the sponsor, rank, identity and agreement fields are added by the detail and update endpoints only.
Show child attributes
Show child attributes
⌘I
Create a customer
curl --request POST \
--url https://api.fluid.app/api/customers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"email": "robert.california@sabre.com",
"first_name": "Robert",
"last_name": "California",
"phone": "+15705550199",
"dob": "1974-03-25",
"external_id": "crm-00048377",
"notes": "Bulk buyer for the Tallahassee office.",
"metadata": {
"referral_source": "sales-call"
},
"default_address_attributes": {
"name": "Robert California",
"address1": "1725 Slough Avenue",
"address2": "Suite 200",
"city": "Scranton",
"state": "PA",
"postal_code": "18505",
"country_code": "US"
}
}
'import requests
url = "https://api.fluid.app/api/customers"
payload = {
"email": "robert.california@sabre.com",
"first_name": "Robert",
"last_name": "California",
"phone": "+15705550199",
"dob": "1974-03-25",
"external_id": "crm-00048377",
"notes": "Bulk buyer for the Tallahassee office.",
"metadata": { "referral_source": "sales-call" },
"default_address_attributes": {
"name": "Robert California",
"address1": "1725 Slough Avenue",
"address2": "Suite 200",
"city": "Scranton",
"state": "PA",
"postal_code": "18505",
"country_code": "US"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
email: 'robert.california@sabre.com',
first_name: 'Robert',
last_name: 'California',
phone: '+15705550199',
dob: '1974-03-25',
external_id: 'crm-00048377',
notes: 'Bulk buyer for the Tallahassee office.',
metadata: {referral_source: 'sales-call'},
default_address_attributes: {
name: 'Robert California',
address1: '1725 Slough Avenue',
address2: 'Suite 200',
city: 'Scranton',
state: 'PA',
postal_code: '18505',
country_code: 'US'
}
})
};
fetch('https://api.fluid.app/api/customers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/customers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'email' => 'robert.california@sabre.com',
'first_name' => 'Robert',
'last_name' => 'California',
'phone' => '+15705550199',
'dob' => '1974-03-25',
'external_id' => 'crm-00048377',
'notes' => 'Bulk buyer for the Tallahassee office.',
'metadata' => [
'referral_source' => 'sales-call'
],
'default_address_attributes' => [
'name' => 'Robert California',
'address1' => '1725 Slough Avenue',
'address2' => 'Suite 200',
'city' => 'Scranton',
'state' => 'PA',
'postal_code' => '18505',
'country_code' => 'US'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/customers"
payload := strings.NewReader("{\n \"email\": \"robert.california@sabre.com\",\n \"first_name\": \"Robert\",\n \"last_name\": \"California\",\n \"phone\": \"+15705550199\",\n \"dob\": \"1974-03-25\",\n \"external_id\": \"crm-00048377\",\n \"notes\": \"Bulk buyer for the Tallahassee office.\",\n \"metadata\": {\n \"referral_source\": \"sales-call\"\n },\n \"default_address_attributes\": {\n \"name\": \"Robert California\",\n \"address1\": \"1725 Slough Avenue\",\n \"address2\": \"Suite 200\",\n \"city\": \"Scranton\",\n \"state\": \"PA\",\n \"postal_code\": \"18505\",\n \"country_code\": \"US\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fluid.app/api/customers")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"email\": \"robert.california@sabre.com\",\n \"first_name\": \"Robert\",\n \"last_name\": \"California\",\n \"phone\": \"+15705550199\",\n \"dob\": \"1974-03-25\",\n \"external_id\": \"crm-00048377\",\n \"notes\": \"Bulk buyer for the Tallahassee office.\",\n \"metadata\": {\n \"referral_source\": \"sales-call\"\n },\n \"default_address_attributes\": {\n \"name\": \"Robert California\",\n \"address1\": \"1725 Slough Avenue\",\n \"address2\": \"Suite 200\",\n \"city\": \"Scranton\",\n \"state\": \"PA\",\n \"postal_code\": \"18505\",\n \"country_code\": \"US\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/customers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"email\": \"robert.california@sabre.com\",\n \"first_name\": \"Robert\",\n \"last_name\": \"California\",\n \"phone\": \"+15705550199\",\n \"dob\": \"1974-03-25\",\n \"external_id\": \"crm-00048377\",\n \"notes\": \"Bulk buyer for the Tallahassee office.\",\n \"metadata\": {\n \"referral_source\": \"sales-call\"\n },\n \"default_address_attributes\": {\n \"name\": \"Robert California\",\n \"address1\": \"1725 Slough Avenue\",\n \"address2\": \"Suite 200\",\n \"city\": \"Scranton\",\n \"state\": \"PA\",\n \"postal_code\": \"18505\",\n \"country_code\": \"US\"\n }\n}"
response = http.request(request)
puts response.read_body{
"customer": {
"id": 48377,
"full_name": "Robert California",
"email": "robert.california@sabre.com",
"created_at": "2026-09-30T15:42:06Z",
"user_company_id": 90611,
"metadata": {
"referral_source": "sales-call"
},
"email_marketing": false,
"sms_marketing": false,
"account_id": "DM-CUST-48377",
"phone": "+15705550199",
"external_id": "crm-00048377",
"first_name": "Robert",
"last_name": "California",
"verified_email": false,
"orders_count": 0,
"display_total_spent": "$0.00",
"name": "Robert California",
"role": "customer",
"last_order_id": null,
"notes": "Bulk buyer for the Tallahassee office.",
"active": true,
"total_spent": "0.0",
"customer_notes": [],
"default_address": {
"id": 331402,
"name": "Robert California",
"address1": "1725 Slough Avenue",
"address2": "Suite 200",
"address3": null,
"city": "Scranton",
"state": "PA",
"subdivision_code": "PA",
"postal_code": "18505",
"country_code": "US",
"phone": null,
"country_num_code": 840,
"default": true
},
"addresses": [
{
"id": 331402,
"name": "Robert California",
"address1": "1725 Slough Avenue",
"address2": "Suite 200",
"address3": null,
"city": "Scranton",
"state": "PA",
"subdivision_code": "PA",
"postal_code": "18505",
"country_code": "US",
"phone": null,
"country_num_code": 840,
"default": true
}
],
"payment_methods": [],
"is_rep": false,
"is_discarded": false,
"tax_exempt": false,
"sales_tax_id": null,
"active_subscriptions_count": 0,
"inactive_subscriptions_count": 0,
"metafields": [],
"member_id": "019f93c7-5e20-7a4b-b1d8-3c7e0f2a9d64",
"jwt": ""
},
"meta": {
"request_id": "c4b1e8f2-3a7d-4e19-9b62-5d0f7a2c8e41",
"timestamp": "2026-09-30T15:42:07Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"code": "<string>",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30",
"payment_uuid": "<string>",
"error_details": [
{
"code": "<string>",
"field": "<string>",
"payment": "not_attempted",
"message": "<string>"
}
],
"coded_recovery": true
}
}