Update customer

PATCH

api

{version}

customers

{id}

Update customer

curl --request PATCH \
  --url https://integrations.alvys.com/api/p/v{version}/customers/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json-patch+json' \
  --header 'If-Match: <if-match>' \
  --data '
{
  "Name": "<string>",
  "Type": "<string>",
  "CompanyNumber": "<string>",
  "Status": "<string>",
  "BillingAddress": {
    "Street": "<string>",
    "City": "<string>",
    "State": "<string>",
    "Zip": "<string>",
    "Country": "<string>"
  },
  "Email": [
    "<string>"
  ],
  "Phone": [
    "<string>"
  ],
  "Fax": "<string>",
  "ExternalId": "<string>"
}
'

const options = {
  method: 'PATCH',
  headers: {
    'If-Match': '<if-match>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json-patch+json'
  },
  body: JSON.stringify({
    Name: '<string>',
    Type: '<string>',
    CompanyNumber: '<string>',
    Status: '<string>',
    BillingAddress: {
      Street: '<string>',
      City: '<string>',
      State: '<string>',
      Zip: '<string>',
      Country: '<string>'
    },
    Email: ['<string>'],
    Phone: ['<string>'],
    Fax: '<string>',
    ExternalId: '<string>'
  })
};

fetch('https://integrations.alvys.com/api/p/v{version}/customers/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://integrations.alvys.com/api/p/v{version}/customers/{id}"

payload = {
    "Name": "<string>",
    "Type": "<string>",
    "CompanyNumber": "<string>",
    "Status": "<string>",
    "BillingAddress": {
        "Street": "<string>",
        "City": "<string>",
        "State": "<string>",
        "Zip": "<string>",
        "Country": "<string>"
    },
    "Email": ["<string>"],
    "Phone": ["<string>"],
    "Fax": "<string>",
    "ExternalId": "<string>"
}
headers = {
    "If-Match": "<if-match>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json-patch+json"
}

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

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://integrations.alvys.com/api/p/v{version}/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>',
    'CompanyNumber' => '<string>',
    'Status' => '<string>',
    'BillingAddress' => [
        'Street' => '<string>',
        'City' => '<string>',
        'State' => '<string>',
        'Zip' => '<string>',
        'Country' => '<string>'
    ],
    'Email' => [
        '<string>'
    ],
    'Phone' => [
        '<string>'
    ],
    'Fax' => '<string>',
    'ExternalId' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json-patch+json",
    "If-Match: <if-match>"
  ],
]);

$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://integrations.alvys.com/api/p/v{version}/customers/{id}"

	payload := strings.NewReader("{\n  \"Name\": \"<string>\",\n  \"Type\": \"<string>\",\n  \"CompanyNumber\": \"<string>\",\n  \"Status\": \"<string>\",\n  \"BillingAddress\": {\n    \"Street\": \"<string>\",\n    \"City\": \"<string>\",\n    \"State\": \"<string>\",\n    \"Zip\": \"<string>\",\n    \"Country\": \"<string>\"\n  },\n  \"Email\": [\n    \"<string>\"\n  ],\n  \"Phone\": [\n    \"<string>\"\n  ],\n  \"Fax\": \"<string>\",\n  \"ExternalId\": \"<string>\"\n}")

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

	req.Header.Add("If-Match", "<if-match>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json-patch+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://integrations.alvys.com/api/p/v{version}/customers/{id}")
  .header("If-Match", "<if-match>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json-patch+json")
  .body("{\n  \"Name\": \"<string>\",\n  \"Type\": \"<string>\",\n  \"CompanyNumber\": \"<string>\",\n  \"Status\": \"<string>\",\n  \"BillingAddress\": {\n    \"Street\": \"<string>\",\n    \"City\": \"<string>\",\n    \"State\": \"<string>\",\n    \"Zip\": \"<string>\",\n    \"Country\": \"<string>\"\n  },\n  \"Email\": [\n    \"<string>\"\n  ],\n  \"Phone\": [\n    \"<string>\"\n  ],\n  \"Fax\": \"<string>\",\n  \"ExternalId\": \"<string>\"\n}")
  .asString();

{
  "Id": "<string>",
  "ETag": "<string>",
  "Name": "<string>",
  "CompanyNumber": "<string>",
  "Type": "<string>",
  "Status": "<string>",
  "Email": [
    "<string>"
  ],
  "Phone": [
    "<string>"
  ],
  "BillingAddress": {
    "Street": "<string>",
    "City": "<string>",
    "State": "<string>",
    "ZipCode": "<string>",
    "Country": "<string>"
  },
  "Fax": "<string>",
  "DateCreated": "2023-11-07T05:31:56Z",
  "DateModified": "2023-11-07T05:31:56Z",
  "InvoicingInformation": {
    "EmailAddresses": [
      "<string>"
    ],
    "Address": {
      "Street": "<string>",
      "City": "<string>",
      "State": "<string>",
      "ZipCode": "<string>",
      "Country": "<string>"
    },
    "PhoneNumber": "<string>",
    "InvoicingName": "<string>",
    "InvoicingNameAlias": "<string>",
    "PaymentType": "<string>",
    "PaymentTermsInDays": 123
  },
  "ExternalId": "<string>"
}

{
  "Errors": {},
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

The Update Customer endpoint applies a partial update (RFC 7396 JSON Merge Patch) to an existing business company. Send only the fields you want to change; omitted fields keep their persisted values. For more information on how versioning works and how to include it in your requests, please refer to the Versioning page. This endpoint uses optimistic concurrency. You must send the customer’s current ETag in an If-Match header. The token is returned on the ETag response header of a GET, and in the body of a create/update response. If the token does not match the current record the request fails with 412 Precondition Failed; refetch with GET to obtain a fresh value and retry.

Request Parameters

The following parameters are required in the URL path:

Parameter	Type	Required	Description
version	String	Yes	The version of the API.
id	String	Yes	The unique identifier of the customer.

The following header is required:

Header	Required	Description
If-Match	Yes	The current `ETag` of the customer being updated.

Request Body

All fields are optional. Provide only the fields you want to change.

Field	Type	Required	Description
Name	String	No	The customer name. Must be 200 characters or fewer. Cannot be blank when present.
Type	String	No	The customer type. One of “Customer” or “Broker/3PL”.
CompanyNumber	String	No	A reference/registration number for the company. Must be 32 characters or fewer.
Status	String	No	The customer status. One of “Active” or “Inactive”.
BillingAddress	Object	No	The billing address of the customer.
BillingAddress.Street	String	No	The street line of the billing address.
BillingAddress.City	String	No	The city of the billing address.
BillingAddress.State	String	No	The state of the billing address.
BillingAddress.Zip	String	No	The postal code of the billing address.
BillingAddress.Country	String	No	ISO country code of the billing address. Defaults to “US”.
Email	Array of String	No	A list of email addresses associated with the customer.
Phone	Array of String	No	A list of phone numbers associated with the customer.
Fax	String	No	The fax number of the customer.
ExternalId	String	No	An external reference identifier. Must be 100 characters or fewer.

Example CURL Request

curl --location --request PATCH 'https://integrations.alvys.com/api/p/v1/customers/01fec4d332ed49ff96595c8d4434ea96' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--header 'If-Match: "00000000-0000-0000-0000-000000000001"' \
--data-raw '{
  "Status": "Inactive"
}'

Replace YOUR_ACCESS_TOKEN with your actual Bearer token and If-Match with the customer’s current ETag.

Response Fields

A successful request returns the updated customer. The new optimistic-concurrency token is returned on the ETag response header and in the ETag body field.

Field	Type	Description
Id	String	The unique identifier of the customer.
ETag	String	The optimistic-concurrency token after the update.
Name	String	The name of the customer.
CompanyNumber	String	The company number of the customer.
Type	String	The type of customer (“Customer” or “Broker/3PL”).
Status	String	The raw persisted status of the customer.
BillingAddress	Object	The billing address of the customer.
BillingAddress.Street	String	The street line of the billing address.
BillingAddress.City	String	The city of the billing address.
BillingAddress.State	String	The state of the billing address.
BillingAddress.ZipCode	String	The postal code of the billing address.
Email	Array	A list of email addresses associated with the customer.
Phone	Array	A list of phone numbers associated with the customer.
Fax	String	The fax number of the customer.
DateCreated	String (Date-Time)	The date and time when the customer was created.
DateModified	String (Date-Time)	The date and time of this update.
InvoicingInformation	Object	The invoicing information for the customer.
ExternalId	String	The external identifier associated with the customer.

Example Response

200 OK

{
  "Id": "01fec4d332ed49ff96595c8d4434ea96",
  "ETag": "\"00000000-0000-0000-0000-000000000002\"",
  "Name": "Acme Logistics",
  "CompanyNumber": "ACME-001",
  "Type": "Broker/3PL",
  "Status": "Inactive",
  "BillingAddress": {
    "Street": "123 Main St",
    "City": "Dallas",
    "State": "TX",
    "ZipCode": "75201"
  },
  "Email": ["billing@acme.example"],
  "Phone": ["+1-214-555-0100"],
  "Fax": null,
  "DateCreated": "2025-09-08T19:38:34.529Z",
  "DateModified": "2025-09-09T11:02:10.118Z",
  "InvoicingInformation": null,
  "ExternalId": "EXT-ACME-001"
}

Status Codes

Status	Meaning
200	The customer was updated.
400	The request body failed validation.
401	The request was not authenticated.
403	The caller lacks permission to update customers.
404	No customer with the given `id` exists.
409	The update would collide with another customer’s unique values.
412	The supplied `If-Match` token did not match the current record. Refetch with GET and retry.
428	The `If-Match` header is required but was not provided.

Rate Limits

All endpoints are subject to rate limits to protect the API from traffic spikes. For detailed information on rate limits, please refer to the Rate Limits section. This page is interactive, allowing you to try a request by completing the fields for the parameters below. As you fill out the parameters, the CURL command on the right side of the page will be automatically updated.

Authorizations

Authorization

string

header

required

OAuth 2.0 client-credentials access token. Obtain one from https://auth.alvys.com/oauth/token (grant_type=client_credentials, audience=https://api.alvys.com/public/), then paste it here. The playground sends it as Authorization: Bearer <token>.

Headers

If-Match

string

required

The customer's current ETag (from a prior GET response header, or the ETag field of a create/update response), for optimistic concurrency. Required; if omitted the request is rejected with 428, and if it does not match the current record with 412.

Path Parameters

string

required

version

string

default:1.0

required

API version (e.g., 1.0)

Example:

"1.0"

Body

Name

string | null

Type

string | null

CompanyNumber

string | null

Status

string | null

BillingAddress

object | null

Show child attributes

string[] | null

Phone

string[] | null

Fax

string | null

ExternalId

string | null

Response

string

required

ETag

string

required

Name

string

required

CompanyNumber

string

required

Type

string

required

Status

string

required

string[]

required

Phone

string[]

required

BillingAddress

object | null

Show child attributes

Fax

string | null

DateCreated

string<date-time> | null

DateModified

string<date-time> | null

InvoicingInformation

object | null

Show child attributes

ExternalId

string | null

⌘I

Update customer

curl --request PATCH \
  --url https://integrations.alvys.com/api/p/v{version}/customers/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json-patch+json' \
  --header 'If-Match: <if-match>' \
  --data '
{
  "Name": "<string>",
  "Type": "<string>",
  "CompanyNumber": "<string>",
  "Status": "<string>",
  "BillingAddress": {
    "Street": "<string>",
    "City": "<string>",
    "State": "<string>",
    "Zip": "<string>",
    "Country": "<string>"
  },
  "Email": [
    "<string>"
  ],
  "Phone": [
    "<string>"
  ],
  "Fax": "<string>",
  "ExternalId": "<string>"
}
'

const options = {
  method: 'PATCH',
  headers: {
    'If-Match': '<if-match>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json-patch+json'
  },
  body: JSON.stringify({
    Name: '<string>',
    Type: '<string>',
    CompanyNumber: '<string>',
    Status: '<string>',
    BillingAddress: {
      Street: '<string>',
      City: '<string>',
      State: '<string>',
      Zip: '<string>',
      Country: '<string>'
    },
    Email: ['<string>'],
    Phone: ['<string>'],
    Fax: '<string>',
    ExternalId: '<string>'
  })
};

fetch('https://integrations.alvys.com/api/p/v{version}/customers/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://integrations.alvys.com/api/p/v{version}/customers/{id}"

payload = {
    "Name": "<string>",
    "Type": "<string>",
    "CompanyNumber": "<string>",
    "Status": "<string>",
    "BillingAddress": {
        "Street": "<string>",
        "City": "<string>",
        "State": "<string>",
        "Zip": "<string>",
        "Country": "<string>"
    },
    "Email": ["<string>"],
    "Phone": ["<string>"],
    "Fax": "<string>",
    "ExternalId": "<string>"
}
headers = {
    "If-Match": "<if-match>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json-patch+json"
}

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

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://integrations.alvys.com/api/p/v{version}/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>',
    'CompanyNumber' => '<string>',
    'Status' => '<string>',
    'BillingAddress' => [
        'Street' => '<string>',
        'City' => '<string>',
        'State' => '<string>',
        'Zip' => '<string>',
        'Country' => '<string>'
    ],
    'Email' => [
        '<string>'
    ],
    'Phone' => [
        '<string>'
    ],
    'Fax' => '<string>',
    'ExternalId' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json-patch+json",
    "If-Match: <if-match>"
  ],
]);

$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://integrations.alvys.com/api/p/v{version}/customers/{id}"

	payload := strings.NewReader("{\n  \"Name\": \"<string>\",\n  \"Type\": \"<string>\",\n  \"CompanyNumber\": \"<string>\",\n  \"Status\": \"<string>\",\n  \"BillingAddress\": {\n    \"Street\": \"<string>\",\n    \"City\": \"<string>\",\n    \"State\": \"<string>\",\n    \"Zip\": \"<string>\",\n    \"Country\": \"<string>\"\n  },\n  \"Email\": [\n    \"<string>\"\n  ],\n  \"Phone\": [\n    \"<string>\"\n  ],\n  \"Fax\": \"<string>\",\n  \"ExternalId\": \"<string>\"\n}")

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

	req.Header.Add("If-Match", "<if-match>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json-patch+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://integrations.alvys.com/api/p/v{version}/customers/{id}")
  .header("If-Match", "<if-match>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json-patch+json")
  .body("{\n  \"Name\": \"<string>\",\n  \"Type\": \"<string>\",\n  \"CompanyNumber\": \"<string>\",\n  \"Status\": \"<string>\",\n  \"BillingAddress\": {\n    \"Street\": \"<string>\",\n    \"City\": \"<string>\",\n    \"State\": \"<string>\",\n    \"Zip\": \"<string>\",\n    \"Country\": \"<string>\"\n  },\n  \"Email\": [\n    \"<string>\"\n  ],\n  \"Phone\": [\n    \"<string>\"\n  ],\n  \"Fax\": \"<string>\",\n  \"ExternalId\": \"<string>\"\n}")
  .asString();

{
  "Id": "<string>",
  "ETag": "<string>",
  "Name": "<string>",
  "CompanyNumber": "<string>",
  "Type": "<string>",
  "Status": "<string>",
  "Email": [
    "<string>"
  ],
  "Phone": [
    "<string>"
  ],
  "BillingAddress": {
    "Street": "<string>",
    "City": "<string>",
    "State": "<string>",
    "ZipCode": "<string>",
    "Country": "<string>"
  },
  "Fax": "<string>",
  "DateCreated": "2023-11-07T05:31:56Z",
  "DateModified": "2023-11-07T05:31:56Z",
  "InvoicingInformation": {
    "EmailAddresses": [
      "<string>"
    ],
    "Address": {
      "Street": "<string>",
      "City": "<string>",
      "State": "<string>",
      "ZipCode": "<string>",
      "Country": "<string>"
    },
    "PhoneNumber": "<string>",
    "InvoicingName": "<string>",
    "InvoicingNameAlias": "<string>",
    "PaymentType": "<string>",
    "PaymentTermsInDays": 123
  },
  "ExternalId": "<string>"
}

{
  "Errors": {},
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

​Request Parameters

​Request Body

​Example CURL Request

​Response Fields

​Example Response

​Status Codes

​Rate Limits

Authorizations

Headers

Path Parameters

Body

Response

Request Parameters

Request Body

Example CURL Request

Response Fields

Example Response

Status Codes

Rate Limits