Create a customer

curl --request POST \
  --url https://api.fluid.app/api/v2025-06/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer": {
    "email": "holly.flax@dundermifflin.com",
    "first_name": "Holly",
    "last_name": "Flax",
    "phone": "+16035550148",
    "account_id": "DM-CUST-10482",
    "external_id": "crm-99812",
    "role": "customer",
    "metadata": {
      "loyalty_tier": "gold",
      "referral_source": "scranton-trade-show"
    },
    "email_marketing": true,
    "sms_marketing": false,
    "tax_exempt": false,
    "notes": "Prefers deliveries to the Nashua branch front desk.",
    "address": {
      "name": "Holly Flax",
      "address1": "14 Amherst Street",
      "address2": "Apt 3",
      "city": "Nashua",
      "state": "NH",
      "postal_code": "03064",
      "country": "US"
    }
  }
}
'

import requests

url = "https://api.fluid.app/api/v2025-06/customers"

payload = { "customer": {
        "email": "holly.flax@dundermifflin.com",
        "first_name": "Holly",
        "last_name": "Flax",
        "phone": "+16035550148",
        "account_id": "DM-CUST-10482",
        "external_id": "crm-99812",
        "role": "customer",
        "metadata": {
            "loyalty_tier": "gold",
            "referral_source": "scranton-trade-show"
        },
        "email_marketing": True,
        "sms_marketing": False,
        "tax_exempt": False,
        "notes": "Prefers deliveries to the Nashua branch front desk.",
        "address": {
            "name": "Holly Flax",
            "address1": "14 Amherst Street",
            "address2": "Apt 3",
            "city": "Nashua",
            "state": "NH",
            "postal_code": "03064",
            "country": "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({
    customer: {
      email: 'holly.flax@dundermifflin.com',
      first_name: 'Holly',
      last_name: 'Flax',
      phone: '+16035550148',
      account_id: 'DM-CUST-10482',
      external_id: 'crm-99812',
      role: 'customer',
      metadata: {loyalty_tier: 'gold', referral_source: 'scranton-trade-show'},
      email_marketing: true,
      sms_marketing: false,
      tax_exempt: false,
      notes: 'Prefers deliveries to the Nashua branch front desk.',
      address: {
        name: 'Holly Flax',
        address1: '14 Amherst Street',
        address2: 'Apt 3',
        city: 'Nashua',
        state: 'NH',
        postal_code: '03064',
        country: 'US'
      }
    }
  })
};

fetch('https://api.fluid.app/api/v2025-06/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/v2025-06/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([
    'customer' => [
        'email' => 'holly.flax@dundermifflin.com',
        'first_name' => 'Holly',
        'last_name' => 'Flax',
        'phone' => '+16035550148',
        'account_id' => 'DM-CUST-10482',
        'external_id' => 'crm-99812',
        'role' => 'customer',
        'metadata' => [
                'loyalty_tier' => 'gold',
                'referral_source' => 'scranton-trade-show'
        ],
        'email_marketing' => true,
        'sms_marketing' => false,
        'tax_exempt' => false,
        'notes' => 'Prefers deliveries to the Nashua branch front desk.',
        'address' => [
                'name' => 'Holly Flax',
                'address1' => '14 Amherst Street',
                'address2' => 'Apt 3',
                'city' => 'Nashua',
                'state' => 'NH',
                'postal_code' => '03064',
                'country' => '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/v2025-06/customers"

	payload := strings.NewReader("{\n  \"customer\": {\n    \"email\": \"holly.flax@dundermifflin.com\",\n    \"first_name\": \"Holly\",\n    \"last_name\": \"Flax\",\n    \"phone\": \"+16035550148\",\n    \"account_id\": \"DM-CUST-10482\",\n    \"external_id\": \"crm-99812\",\n    \"role\": \"customer\",\n    \"metadata\": {\n      \"loyalty_tier\": \"gold\",\n      \"referral_source\": \"scranton-trade-show\"\n    },\n    \"email_marketing\": true,\n    \"sms_marketing\": false,\n    \"tax_exempt\": false,\n    \"notes\": \"Prefers deliveries to the Nashua branch front desk.\",\n    \"address\": {\n      \"name\": \"Holly Flax\",\n      \"address1\": \"14 Amherst Street\",\n      \"address2\": \"Apt 3\",\n      \"city\": \"Nashua\",\n      \"state\": \"NH\",\n      \"postal_code\": \"03064\",\n      \"country\": \"US\"\n    }\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/v2025-06/customers")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"customer\": {\n    \"email\": \"holly.flax@dundermifflin.com\",\n    \"first_name\": \"Holly\",\n    \"last_name\": \"Flax\",\n    \"phone\": \"+16035550148\",\n    \"account_id\": \"DM-CUST-10482\",\n    \"external_id\": \"crm-99812\",\n    \"role\": \"customer\",\n    \"metadata\": {\n      \"loyalty_tier\": \"gold\",\n      \"referral_source\": \"scranton-trade-show\"\n    },\n    \"email_marketing\": true,\n    \"sms_marketing\": false,\n    \"tax_exempt\": false,\n    \"notes\": \"Prefers deliveries to the Nashua branch front desk.\",\n    \"address\": {\n      \"name\": \"Holly Flax\",\n      \"address1\": \"14 Amherst Street\",\n      \"address2\": \"Apt 3\",\n      \"city\": \"Nashua\",\n      \"state\": \"NH\",\n      \"postal_code\": \"03064\",\n      \"country\": \"US\"\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/v2025-06/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  \"customer\": {\n    \"email\": \"holly.flax@dundermifflin.com\",\n    \"first_name\": \"Holly\",\n    \"last_name\": \"Flax\",\n    \"phone\": \"+16035550148\",\n    \"account_id\": \"DM-CUST-10482\",\n    \"external_id\": \"crm-99812\",\n    \"role\": \"customer\",\n    \"metadata\": {\n      \"loyalty_tier\": \"gold\",\n      \"referral_source\": \"scranton-trade-show\"\n    },\n    \"email_marketing\": true,\n    \"sms_marketing\": false,\n    \"tax_exempt\": false,\n    \"notes\": \"Prefers deliveries to the Nashua branch front desk.\",\n    \"address\": {\n      \"name\": \"Holly Flax\",\n      \"address1\": \"14 Amherst Street\",\n      \"address2\": \"Apt 3\",\n      \"city\": \"Nashua\",\n      \"state\": \"NH\",\n      \"postal_code\": \"03064\",\n      \"country\": \"US\"\n    }\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-30T14:15:21Z",
    "user_company_id": 77120,
    "metadata": {
      "loyalty_tier": "gold",
      "referral_source": "scranton-trade-show"
    },
    "email_marketing": true,
    "sms_marketing": false,
    "tax_exempt": false,
    "sales_tax_id": null,
    "account_id": "DM-CUST-10482",
    "phone": "+16035550148",
    "external_id": "crm-99812",
    "member_id": "01926f3a-5c2e-7b41-9d8e-2f4a6c1b7e93",
    "first_name": "Holly",
    "last_name": "Flax",
    "verified_email": true,
    "orders_count": 0,
    "display_total_spent": "$0.00",
    "name": "Holly Flax",
    "role": "customer",
    "last_order_id": null,
    "notes": "Prefers deliveries to the Nashua branch front desk.",
    "active": true,
    "total_spent": 0,
    "customer_notes": [],
    "default_address": {
      "id": 30551,
      "name": "Holly Flax",
      "address1": "14 Amherst Street",
      "address2": "Apt 3",
      "address3": null,
      "city": "Nashua",
      "state": "NH",
      "subdivision_code": "NH",
      "postal_code": "03064",
      "country_code": "US",
      "phone": "+16035550148",
      "country_num_code": 840,
      "default": true
    },
    "addresses": [
      {
        "id": 30551,
        "name": "Holly Flax",
        "address1": "14 Amherst Street",
        "address2": "Apt 3",
        "address3": null,
        "city": "Nashua",
        "state": "NH",
        "subdivision_code": "NH",
        "postal_code": "03064",
        "country_code": "US",
        "phone": "+16035550148",
        "country_num_code": 840,
        "default": true
      }
    ],
    "payment_methods": [],
    "is_rep": false,
    "is_discarded": false
  },
  "meta": {
    "request_id": "c0a8012e-7f3b-4d6a-9e21-5b8d4f2a6c17",
    "timestamp": "2026-09-30T14:15:22Z"
  }
}

{
  "message": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 123,
      "prev_cursor": "<string>",
      "next_cursor": "<string>",
      "total_count": 123
    }
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 123,
      "prev_cursor": "<string>",
      "next_cursor": "<string>",
      "total_count": 123
    }
  }
}

{
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 123,
      "prev_cursor": "<string>",
      "next_cursor": "<string>",
      "total_count": 123
    }
  }
}