Legacy (v0)
Update a customer (PUT)
The PUT form of PATCH /api/customers/{id}. Both methods reach one
update action, take the same body and return the same responses. Read
that operation for the details.
PUT
/
api
/
customers
/
{id}
Update a customer (PUT)
curl --request PUT \
--url https://api.fluid.app/api/customers/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"first_name": "Holly",
"last_name": "Flax",
"phone": "+15705550142",
"email_marketing": true,
"notes": "Prefers deliveries left with reception.",
"default_address_attributes": {
"address1": "412 Keystone Road",
"address2": "Apt 3",
"city": "Scranton",
"state": "PA",
"postal_code": "18505",
"country_code": "US"
}
}
'import requests
url = "https://api.fluid.app/api/customers/{id}"
payload = {
"first_name": "Holly",
"last_name": "Flax",
"phone": "+15705550142",
"email_marketing": True,
"notes": "Prefers deliveries left with reception.",
"default_address_attributes": {
"address1": "412 Keystone Road",
"address2": "Apt 3",
"city": "Scranton",
"state": "PA",
"postal_code": "18505",
"country_code": "US"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
first_name: 'Holly',
last_name: 'Flax',
phone: '+15705550142',
email_marketing: true,
notes: 'Prefers deliveries left with reception.',
default_address_attributes: {
address1: '412 Keystone Road',
address2: 'Apt 3',
city: 'Scranton',
state: 'PA',
postal_code: '18505',
country_code: 'US'
}
})
};
fetch('https://api.fluid.app/api/customers/{id}', 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/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'first_name' => 'Holly',
'last_name' => 'Flax',
'phone' => '+15705550142',
'email_marketing' => true,
'notes' => 'Prefers deliveries left with reception.',
'default_address_attributes' => [
'address1' => '412 Keystone Road',
'address2' => 'Apt 3',
'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/{id}"
payload := strings.NewReader("{\n \"first_name\": \"Holly\",\n \"last_name\": \"Flax\",\n \"phone\": \"+15705550142\",\n \"email_marketing\": true,\n \"notes\": \"Prefers deliveries left with reception.\",\n \"default_address_attributes\": {\n \"address1\": \"412 Keystone Road\",\n \"address2\": \"Apt 3\",\n \"city\": \"Scranton\",\n \"state\": \"PA\",\n \"postal_code\": \"18505\",\n \"country_code\": \"US\"\n }\n}")
req, _ := http.NewRequest("PUT", 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.put("https://api.fluid.app/api/customers/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"first_name\": \"Holly\",\n \"last_name\": \"Flax\",\n \"phone\": \"+15705550142\",\n \"email_marketing\": true,\n \"notes\": \"Prefers deliveries left with reception.\",\n \"default_address_attributes\": {\n \"address1\": \"412 Keystone Road\",\n \"address2\": \"Apt 3\",\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/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"first_name\": \"Holly\",\n \"last_name\": \"Flax\",\n \"phone\": \"+15705550142\",\n \"email_marketing\": true,\n \"notes\": \"Prefers deliveries left with reception.\",\n \"default_address_attributes\": {\n \"address1\": \"412 Keystone Road\",\n \"address2\": \"Apt 3\",\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": 48213,
"full_name": "Holly Flax",
"email": "holly.flax@dundermifflin.com",
"created_at": "2026-09-02T14:18:37Z",
"user_company_id": 90517,
"metadata": {
"loyalty_tier": "gold",
"referral_source": "scranton-business-expo"
},
"email_marketing": true,
"sms_marketing": false,
"account_id": "DM-CUST-48213",
"phone": "+15705550142",
"external_id": "crm-00048213",
"first_name": "Holly",
"last_name": "Flax",
"verified_email": true,
"orders_count": 7,
"display_total_spent": "$384.93",
"name": "Holly Flax",
"role": "customer",
"last_order_id": 771042,
"notes": "Prefers deliveries left with reception.",
"active": true,
"total_spent": "384.93",
"customer_notes": [
{
"id": 5521,
"note": "Asked to switch her standing order to the 24lb paper next quarter.",
"customer_id": 48213,
"resource_id": 48213,
"resource_type": "Customer",
"created_at": "2026-09-14T10:05:12Z",
"user_company_id": 90012,
"user_company": {
"id": 90012,
"first_name": "Michael",
"last_name": "Scott",
"full_name": "Michael Scott",
"email": "michael.scott@dundermifflin.com",
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/michael-scott.jpg"
}
}
],
"default_address": {
"id": 330918,
"name": "Holly Flax",
"address1": "412 Keystone Road",
"address2": "Apt 3",
"address3": null,
"city": "Scranton",
"state": "PA",
"subdivision_code": "PA",
"postal_code": "18505",
"country_code": "US",
"phone": "+15705550142",
"country_num_code": 840,
"default": true
},
"addresses": [
{
"id": 330918,
"name": "Holly Flax",
"address1": "412 Keystone Road",
"address2": "Apt 3",
"address3": null,
"city": "Scranton",
"state": "PA",
"subdivision_code": "PA",
"postal_code": "18505",
"country_code": "US",
"phone": "+15705550142",
"country_num_code": 840,
"default": true
}
],
"payment_methods": [],
"is_rep": false,
"is_discarded": false,
"tax_exempt": false,
"sales_tax_id": null,
"points": 1250,
"points_decimal": "1250.0000",
"attributable_rep": {
"id": 90231,
"first_name": "Dwight",
"last_name": "Schrute",
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/dwight-schrute.jpg"
},
"active_subscriptions_count": 1,
"inactive_subscriptions_count": 0,
"metafields": [],
"member_id": "019f4b2e-7c1a-7d3e-9a41-2f6b8c0d5e17",
"jwt": "",
"username": "holly-flax",
"rank": null,
"language_code": "en",
"member_type_slug": "customer",
"legacy_user_company_id": 90517,
"legacy_customer_id": 48213,
"sponsor": {
"id": 90231,
"first_name": "Dwight",
"last_name": "Schrute",
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/dwight-schrute.jpg",
"external_id": "rep-dwight-schrute",
"username": "dwight-schrute",
"email": "dwight.schrute@dundermifflin.com"
},
"agreement_acceptances": [
{
"id": 18830,
"agreement_id": 412,
"required": true,
"accepted_at": "2026-09-02T14:21:04Z",
"acceptance_context": "checkout",
"title": "Terms of Service",
"order_id": 771042,
"acceptance_method": "customer",
"content_snapshot": "By placing an order with Dunder Mifflin Paper Company you agree to these terms of service."
}
],
"fluid_pay_default_address_id": null
},
"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",
"payment_uuid": "<string>",
"error_details": [
{
"code": "<string>",
"field": "<string>",
"payment": "not_attempted",
"message": "<string>"
}
],
"coded_recovery": true
}
}Authorizations
Bearer token authentication
Path Parameters
Customer's Id
Body
application/json
Request payload
First name of customer
Last name of customer
Email of customer
Phone number of customer
A unique Account Id for customer. If empty, one is generated by the system
A unique External Id for customer that is used to identify them in external systems. Deprecated for new integrations: this v0 endpoint is superseded by PATCH /api/v2025-06/members/{member_id} (operationId admin_v2025_06_members_patch), which accepts the same external_id and is the actively-developed lane for member external IDs. The field and this endpoint remain fully supported for existing integrations; nothing about their behaviour changes.
Note for customer
A JSON object that can store any custom data structure. When provided, replaces all existing metadata data.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Metafields for custom data storage
Show child attributes
Show child attributes
Response
Success
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
Show child attributes
Show child attributes
⌘I
Update a customer (PUT)
curl --request PUT \
--url https://api.fluid.app/api/customers/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"first_name": "Holly",
"last_name": "Flax",
"phone": "+15705550142",
"email_marketing": true,
"notes": "Prefers deliveries left with reception.",
"default_address_attributes": {
"address1": "412 Keystone Road",
"address2": "Apt 3",
"city": "Scranton",
"state": "PA",
"postal_code": "18505",
"country_code": "US"
}
}
'import requests
url = "https://api.fluid.app/api/customers/{id}"
payload = {
"first_name": "Holly",
"last_name": "Flax",
"phone": "+15705550142",
"email_marketing": True,
"notes": "Prefers deliveries left with reception.",
"default_address_attributes": {
"address1": "412 Keystone Road",
"address2": "Apt 3",
"city": "Scranton",
"state": "PA",
"postal_code": "18505",
"country_code": "US"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
first_name: 'Holly',
last_name: 'Flax',
phone: '+15705550142',
email_marketing: true,
notes: 'Prefers deliveries left with reception.',
default_address_attributes: {
address1: '412 Keystone Road',
address2: 'Apt 3',
city: 'Scranton',
state: 'PA',
postal_code: '18505',
country_code: 'US'
}
})
};
fetch('https://api.fluid.app/api/customers/{id}', 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/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'first_name' => 'Holly',
'last_name' => 'Flax',
'phone' => '+15705550142',
'email_marketing' => true,
'notes' => 'Prefers deliveries left with reception.',
'default_address_attributes' => [
'address1' => '412 Keystone Road',
'address2' => 'Apt 3',
'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/{id}"
payload := strings.NewReader("{\n \"first_name\": \"Holly\",\n \"last_name\": \"Flax\",\n \"phone\": \"+15705550142\",\n \"email_marketing\": true,\n \"notes\": \"Prefers deliveries left with reception.\",\n \"default_address_attributes\": {\n \"address1\": \"412 Keystone Road\",\n \"address2\": \"Apt 3\",\n \"city\": \"Scranton\",\n \"state\": \"PA\",\n \"postal_code\": \"18505\",\n \"country_code\": \"US\"\n }\n}")
req, _ := http.NewRequest("PUT", 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.put("https://api.fluid.app/api/customers/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"first_name\": \"Holly\",\n \"last_name\": \"Flax\",\n \"phone\": \"+15705550142\",\n \"email_marketing\": true,\n \"notes\": \"Prefers deliveries left with reception.\",\n \"default_address_attributes\": {\n \"address1\": \"412 Keystone Road\",\n \"address2\": \"Apt 3\",\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/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"first_name\": \"Holly\",\n \"last_name\": \"Flax\",\n \"phone\": \"+15705550142\",\n \"email_marketing\": true,\n \"notes\": \"Prefers deliveries left with reception.\",\n \"default_address_attributes\": {\n \"address1\": \"412 Keystone Road\",\n \"address2\": \"Apt 3\",\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": 48213,
"full_name": "Holly Flax",
"email": "holly.flax@dundermifflin.com",
"created_at": "2026-09-02T14:18:37Z",
"user_company_id": 90517,
"metadata": {
"loyalty_tier": "gold",
"referral_source": "scranton-business-expo"
},
"email_marketing": true,
"sms_marketing": false,
"account_id": "DM-CUST-48213",
"phone": "+15705550142",
"external_id": "crm-00048213",
"first_name": "Holly",
"last_name": "Flax",
"verified_email": true,
"orders_count": 7,
"display_total_spent": "$384.93",
"name": "Holly Flax",
"role": "customer",
"last_order_id": 771042,
"notes": "Prefers deliveries left with reception.",
"active": true,
"total_spent": "384.93",
"customer_notes": [
{
"id": 5521,
"note": "Asked to switch her standing order to the 24lb paper next quarter.",
"customer_id": 48213,
"resource_id": 48213,
"resource_type": "Customer",
"created_at": "2026-09-14T10:05:12Z",
"user_company_id": 90012,
"user_company": {
"id": 90012,
"first_name": "Michael",
"last_name": "Scott",
"full_name": "Michael Scott",
"email": "michael.scott@dundermifflin.com",
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/michael-scott.jpg"
}
}
],
"default_address": {
"id": 330918,
"name": "Holly Flax",
"address1": "412 Keystone Road",
"address2": "Apt 3",
"address3": null,
"city": "Scranton",
"state": "PA",
"subdivision_code": "PA",
"postal_code": "18505",
"country_code": "US",
"phone": "+15705550142",
"country_num_code": 840,
"default": true
},
"addresses": [
{
"id": 330918,
"name": "Holly Flax",
"address1": "412 Keystone Road",
"address2": "Apt 3",
"address3": null,
"city": "Scranton",
"state": "PA",
"subdivision_code": "PA",
"postal_code": "18505",
"country_code": "US",
"phone": "+15705550142",
"country_num_code": 840,
"default": true
}
],
"payment_methods": [],
"is_rep": false,
"is_discarded": false,
"tax_exempt": false,
"sales_tax_id": null,
"points": 1250,
"points_decimal": "1250.0000",
"attributable_rep": {
"id": 90231,
"first_name": "Dwight",
"last_name": "Schrute",
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/dwight-schrute.jpg"
},
"active_subscriptions_count": 1,
"inactive_subscriptions_count": 0,
"metafields": [],
"member_id": "019f4b2e-7c1a-7d3e-9a41-2f6b8c0d5e17",
"jwt": "",
"username": "holly-flax",
"rank": null,
"language_code": "en",
"member_type_slug": "customer",
"legacy_user_company_id": 90517,
"legacy_customer_id": 48213,
"sponsor": {
"id": 90231,
"first_name": "Dwight",
"last_name": "Schrute",
"image_url": "https://cdn.fluid.app/avatars/dunder-mifflin/dwight-schrute.jpg",
"external_id": "rep-dwight-schrute",
"username": "dwight-schrute",
"email": "dwight.schrute@dundermifflin.com"
},
"agreement_acceptances": [
{
"id": 18830,
"agreement_id": 412,
"required": true,
"accepted_at": "2026-09-02T14:21:04Z",
"acceptance_context": "checkout",
"title": "Terms of Service",
"order_id": 771042,
"acceptance_method": "customer",
"content_snapshot": "By placing an order with Dunder Mifflin Paper Company you agree to these terms of service."
}
],
"fluid_pay_default_address_id": null
},
"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",
"payment_uuid": "<string>",
"error_details": [
{
"code": "<string>",
"field": "<string>",
"payment": "not_attempted",
"message": "<string>"
}
],
"coded_recovery": true
}
}