Update Customer

curl --request PATCH \
  --url https://qwoty.app/api/customers/{id} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "type": "<string>",
  "segment_id": {},
  "logo": {},
  "tax_ids": [
    {}
  ],
  "identifiers": {
    "identifiers.crm": {},
    "identifiers.erp": {},
    "identifiers.accounting": {}
  },
  "custom_fields": {}
}
'

import requests

url = "https://qwoty.app/api/customers/{id}"

payload = {
    "name": "<string>",
    "type": "<string>",
    "segment_id": {},
    "logo": {},
    "tax_ids": [{}],
    "identifiers": {
        "identifiers.crm": {},
        "identifiers.erp": {},
        "identifiers.accounting": {}
    },
    "custom_fields": {}
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    type: '<string>',
    segment_id: {},
    logo: {},
    tax_ids: [{}],
    identifiers: {'identifiers.crm': {}, 'identifiers.erp': {}, 'identifiers.accounting': {}},
    custom_fields: {}
  })
};

fetch('https://qwoty.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://qwoty.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 => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'type' => '<string>',
    'segment_id' => [
        
    ],
    'logo' => [
        
    ],
    'tax_ids' => [
        [
                
        ]
    ],
    'identifiers' => [
        'identifiers.crm' => [
                
        ],
        'identifiers.erp' => [
                
        ],
        'identifiers.accounting' => [
                
        ]
    ],
    'custom_fields' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "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://qwoty.app/api/customers/{id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"type\": \"<string>\",\n  \"segment_id\": {},\n  \"logo\": {},\n  \"tax_ids\": [\n    {}\n  ],\n  \"identifiers\": {\n    \"identifiers.crm\": {},\n    \"identifiers.erp\": {},\n    \"identifiers.accounting\": {}\n  },\n  \"custom_fields\": {}\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	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.patch("https://qwoty.app/api/customers/{id}")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"type\": \"<string>\",\n  \"segment_id\": {},\n  \"logo\": {},\n  \"tax_ids\": [\n    {}\n  ],\n  \"identifiers\": {\n    \"identifiers.crm\": {},\n    \"identifiers.erp\": {},\n    \"identifiers.accounting\": {}\n  },\n  \"custom_fields\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://qwoty.app/api/customers/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"type\": \"<string>\",\n  \"segment_id\": {},\n  \"logo\": {},\n  \"tax_ids\": [\n    {}\n  ],\n  \"identifiers\": {\n    \"identifiers.crm\": {},\n    \"identifiers.erp\": {},\n    \"identifiers.accounting\": {}\n  },\n  \"custom_fields\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Acme Corp (Renamed)",
    "type": "company",
    "segment_id": null,
    "logo": null,
    "identifiers": {
      "crm": "crm_001",
      "erp": null,
      "accounting": null
    },
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-03-24T14:00:00Z"
  }
}

{
  "error": "Customer not found"
}

PATCH

api

customers

{id}

Update Customer

curl --request PATCH \
  --url https://qwoty.app/api/customers/{id} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "type": "<string>",
  "segment_id": {},
  "logo": {},
  "tax_ids": [
    {}
  ],
  "identifiers": {
    "identifiers.crm": {},
    "identifiers.erp": {},
    "identifiers.accounting": {}
  },
  "custom_fields": {}
}
'

import requests

url = "https://qwoty.app/api/customers/{id}"

payload = {
    "name": "<string>",
    "type": "<string>",
    "segment_id": {},
    "logo": {},
    "tax_ids": [{}],
    "identifiers": {
        "identifiers.crm": {},
        "identifiers.erp": {},
        "identifiers.accounting": {}
    },
    "custom_fields": {}
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    type: '<string>',
    segment_id: {},
    logo: {},
    tax_ids: [{}],
    identifiers: {'identifiers.crm': {}, 'identifiers.erp': {}, 'identifiers.accounting': {}},
    custom_fields: {}
  })
};

fetch('https://qwoty.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://qwoty.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 => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'type' => '<string>',
    'segment_id' => [
        
    ],
    'logo' => [
        
    ],
    'tax_ids' => [
        [
                
        ]
    ],
    'identifiers' => [
        'identifiers.crm' => [
                
        ],
        'identifiers.erp' => [
                
        ],
        'identifiers.accounting' => [
                
        ]
    ],
    'custom_fields' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "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://qwoty.app/api/customers/{id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"type\": \"<string>\",\n  \"segment_id\": {},\n  \"logo\": {},\n  \"tax_ids\": [\n    {}\n  ],\n  \"identifiers\": {\n    \"identifiers.crm\": {},\n    \"identifiers.erp\": {},\n    \"identifiers.accounting\": {}\n  },\n  \"custom_fields\": {}\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	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.patch("https://qwoty.app/api/customers/{id}")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"type\": \"<string>\",\n  \"segment_id\": {},\n  \"logo\": {},\n  \"tax_ids\": [\n    {}\n  ],\n  \"identifiers\": {\n    \"identifiers.crm\": {},\n    \"identifiers.erp\": {},\n    \"identifiers.accounting\": {}\n  },\n  \"custom_fields\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://qwoty.app/api/customers/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"type\": \"<string>\",\n  \"segment_id\": {},\n  \"logo\": {},\n  \"tax_ids\": [\n    {}\n  ],\n  \"identifiers\": {\n    \"identifiers.crm\": {},\n    \"identifiers.erp\": {},\n    \"identifiers.accounting\": {}\n  },\n  \"custom_fields\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Acme Corp (Renamed)",
    "type": "company",
    "segment_id": null,
    "logo": null,
    "identifiers": {
      "crm": "crm_001",
      "erp": null,
      "accounting": null
    },
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-03-24T14:00:00Z"
  }
}

{
  "error": "Customer not found"
}

Authorization

string

required

Bearer token. Format: Bearer qwoty_your_token

Path Parameters

string

required

UUID of the customer to update

Request Body

All fields are optional. Only the fields provided will be updated.

string

Customer display name

string

Customer type. Allowed values: "company", "individual"

string | null

UUID of the customer segment. Set to null to unset.

string | null

Logo URL. Set to null to unset.

array

Legal identifiers. Replaces all existing tax IDs. Send [] to remove all.Omitting this field leaves existing tax IDs unchanged.

[{ "tax": "VAT", "tax_value": "FR98765432100" }]

object

External system identifiers

Show Identifiers

string | null

CRM identifier. Set to null to unset.

string | null

ERP identifier. Set to null to unset.

string | null

Accounting identifier. Set to null to unset.

object

Custom field values, keyed by the field api_name (JSON Merge Patch, RFC 7396): only the keys sent are written, null clears a value, keys not sent are left unchanged. Values are typed by the field datatype (text → string, number → number, timestamptz → ISO 8601 string). An unknown key or an invalid value returns a 400 and nothing is written.

{ "loyalty_tier": "Platinum", "annual_budget": null }

Examples

curl -X PATCH https://qwoty.app/api/customers/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer qwoty_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp (Renamed)",
    "tax_ids": [
      { "tax": "VAT", "tax_value": "FR98765432100" }
    ]
  }'

const customerId = '550e8400-e29b-41d4-a716-446655440000'

const response = await fetch(`https://qwoty.app/api/customers/${customerId}`, {
  method: 'PATCH',
  headers: {
    Authorization: 'Bearer qwoty_your_token',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'Acme Corp (Renamed)',
    tax_ids: [{ tax: 'VAT', tax_value: 'FR98765432100' }],
  }),
})
const data = await response.json()

import requests

customer_id = '550e8400-e29b-41d4-a716-446655440000'

response = requests.patch(
    f'https://qwoty.app/api/customers/{customer_id}',
    headers={
        'Authorization': 'Bearer qwoty_your_token',
        'Content-Type': 'application/json',
    },
    json={
        'name': 'Acme Corp (Renamed)',
        'tax_ids': [{'tax': 'VAT', 'tax_value': 'FR98765432100'}],
    },
)
data = response.json()

Response

boolean

true if the update succeeded

object

The updated customer object (same shape as Get Customer)

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Acme Corp (Renamed)",
    "type": "company",
    "segment_id": null,
    "logo": null,
    "identifiers": {
      "crm": "crm_001",
      "erp": null,
      "accounting": null
    },
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-03-24T14:00:00Z"
  }
}

{
  "error": "Customer not found"
}

Last modified on October 28, 2026

Catalogs

Categories

Product Parents

Products

Prices

Payment Terms

Customers

Contacts

Addresses

Quotes

Media

Tokens

Update Customer

Authorization

Path Parameters

Request Body

Examples

Response

​Authorization

​Path Parameters

​Request Body

​Examples

​Response

Authorization

Path Parameters

Request Body

Examples

Response