Customers
Update Customer
Customers
Update Customer
PUT
/
api
/
customers
/
{customerId}
curl --request PUT \
--url https://api.atoa.me/api/customers/{customerId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"fullName": "John Doe Updated",
"address": "456 New Street",
"city": "Manchester"
}'
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"fullName": "John Doe Updated",
"email": "john.doe@example.com",
"type": "INDIVIDUAL",
"phoneCountryCode": "44",
"phoneNumber": "7911123456",
"address": "456 New Street",
"city": "Manchester",
"postcode": "SW1A 1AA",
"createdAt": "2025-06-15T10:30:00.000Z"
}
Update a customer by ID. All fields are optional — only include the fields you want to update.
Authorization
Bearer <accessSecret>
Path Parameters
customerId
string
requiredThe customer’s unique identifier (UUID).
Request Body Schema
All fields are optional. Same validation rules as Create Customer.
fullName
string
Customer’s full name (2-30 characters).
email
string
Valid email address.
type
string
INDIVIDUAL or BUSINESS.
phoneCountryCode
string
Phone country code (max 5 chars, digits only).
phoneNumber
string
Phone number (max 15 chars, digits only).
address
string
Customer’s address (max 100 characters).
city
string
Customer’s city (max 30 characters).
postcode
string
Postcode (4-8 characters, alphanumeric).
vatNumber
string
VAT number (9 digits, optionally prefixed with GB).
curl --request PUT \
--url https://api.atoa.me/api/customers/{customerId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"fullName": "John Doe Updated",
"address": "456 New Street",
"city": "Manchester"
}'
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"fullName": "John Doe Updated",
"email": "john.doe@example.com",
"type": "INDIVIDUAL",
"phoneCountryCode": "44",
"phoneNumber": "7911123456",
"address": "456 New Street",
"city": "Manchester",
"postcode": "SW1A 1AA",
"createdAt": "2025-06-15T10:30:00.000Z"
}