Update Customer

curl --request PATCH \
  --url https://app-api.my-virtual-office.com/api/customers/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "first_name": "<string>",
  "last_name": "<string>",
  "email": "<string>",
  "company_name": "<string>",
  "legal_entity": "<string>",
  "language": "<string>",
  "status": "<string>",
  "address_data": {
    "street": "<string>",
    "city": "<string>",
    "postal_code": "<string>",
    "country": "<string>"
  },
  "postal_redirect_address": {
    "street": "<string>",
    "city": "<string>",
    "postal_code": "<string>",
    "country": "<string>"
  }
}
'

{
  "error": "Bad Request",
  "message": "body must NOT have fewer than 1 properties"
}

PATCH

api

customers

{id}

Update Customer

curl --request PATCH \
  --url https://app-api.my-virtual-office.com/api/customers/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "first_name": "<string>",
  "last_name": "<string>",
  "email": "<string>",
  "company_name": "<string>",
  "legal_entity": "<string>",
  "language": "<string>",
  "status": "<string>",
  "address_data": {
    "street": "<string>",
    "city": "<string>",
    "postal_code": "<string>",
    "country": "<string>"
  },
  "postal_redirect_address": {
    "street": "<string>",
    "city": "<string>",
    "postal_code": "<string>",
    "country": "<string>"
  }
}
'

{
  "error": "Bad Request",
  "message": "body must NOT have fewer than 1 properties"
}

Update Customer

Update one or more fields of an existing customer. Only fields provided in the request body will be modified.

Authentication

X-API-Key

string

required

Your API key. Can also be provided via Authorization: Bearer header.

Path Parameters

string

required

The UUID of the customer to update.

Request Body

At least one field must be provided.

first_name

string

Customer’s first name. Maximum 100 characters.

last_name

string

Customer’s last name. Maximum 100 characters.

string

Customer’s email address. Must be a valid email format and unique for your account.

company_name

string

Company name. Maximum 200 characters.

legal_entity

string

Legal entity type (e.g., “GmbH”, “LLC”). Maximum 100 characters.

language

string

Preferred language for communications. Must be either en or de.

status

string

Customer status. Must be one of active, inactive, or suspended. Inactive or suspended customers cannot log in to the portal.

address_data

object

Customer’s address information.

Show address_data properties

street

string

Street address. Maximum 200 characters.

city

string

City name. Maximum 100 characters.

postal_code

string

Postal/ZIP code. Maximum 20 characters.

country

string

Country name or code. Maximum 100 characters.

postal_redirect_address

object

Address to which postal mail should be forwarded for this customer.

Show postal_redirect_address properties

street

string

Street address. Maximum 200 characters.

city

string

City name. Maximum 100 characters.

postal_code

string

Postal/ZIP code. Maximum 20 characters.

country

string

Country name or code. Maximum 100 characters.

Response

string

Unique identifier for the customer (UUID)

seller_id

string

Your seller account ID (UUID)

first_name

string

Customer’s first name

last_name

string

Customer’s last name

string

Customer’s email address

company_name

string | null

Company name if provided

legal_entity

string | null

Legal entity type if provided

language

string | null

Preferred language

address_data

object | null

Address information if provided

postal_redirect_address

object | null

Postal redirect address if set

status

string

Customer status (active, inactive, or suspended)

source

string

Source of customer creation (e.g., “api”)

created_at

string

ISO 8601 timestamp of when the customer was created

updated_at

string

ISO 8601 timestamp of when the customer was last updated

Example Request

curl -X PATCH https://app-api.my-virtual-office.com/api/customers/550e8400-e29b-41d4-a716-446655440000 \
  -H "X-API-Key: sk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Jane",
    "company_name": "Acme Corp",
    "language": "en"
  }'

Example Response

200 OK

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "seller_id": "660e8400-e29b-41d4-a716-446655440001",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "john.doe@example.com",
  "company_name": "Acme Corp",
  "legal_entity": "GmbH",
  "language": "en",
  "address_data": {
    "street": "Musterstraße 123",
    "city": "Berlin",
    "postal_code": "10115",
    "country": "Germany"
  },
  "postal_redirect_address": {
    "street": "Weiterleitungsstraße 5",
    "city": "München",
    "postal_code": "80331",
    "country": "Germany"
  },
  "status": "active",
  "source": "api",
  "created_at": "2024-01-15T10:30:00.000Z",
  "updated_at": "2024-02-20T14:15:00.000Z"
}

Error Responses

{
  "error": "Bad Request",
  "message": "body must NOT have fewer than 1 properties"
}

{
  "error": "Unauthorized",
  "message": "API key is required. Provide it via X-API-Key header or Authorization Bearer token."
}

{
  "error": "Not Found",
  "message": "Customer not found"
}

{
  "error": "Conflict",
  "message": "A customer with this email already exists"
}

Error Codes

HTTP Code	Error	Description
400	Bad Request	Invalid request body or no fields provided
401	Unauthorized	Missing or invalid API key
404	Not Found	Customer not found or does not belong to your account
409	Conflict	Email address already exists for another customer
500	Internal Server Error	Unexpected server error

Get Customer Delete Customer

​Update Customer

​Authentication

​Path Parameters

​Request Body

​Response

​Example Request

​Example Response

​Error Responses

​Error Codes

Update Customer

Authentication

Path Parameters

Request Body

Response

Example Request

Example Response

Error Responses

Error Codes