Skip to Content
Developers
Customers

Change a customer

PATCH
/customers/{id}

Changes a customer's name or blocks them. Send only the fields to change. There is no endpoint that makes a customer: making a booking makes its customer.

Keys: a key that may read and change. Any other key gets 403.

Authorization

apiKey
headerAuthorizationBearer wo_live_...

A key from the shop's admin. Secret keys start with wo_live_, public keys with wo_pub_.

Path parameters

id*string

The object's id.

Formatuuid

Header parameters

Idempotency-Key?string

Any unique text, such as a UUID. A retry with the same key and the same request gets the first answer back and changes nothing twice. Kept for 24 hours.

Lengthlength <= 255

Request body

application/json
  1. body
blocked?boolean

True stops online bookings from this customer. Bookings they have stay.

name?string
Length1 <= length <= 120

Response body

The request worked.

application/json
  1. response

A person who booked at the shop.

blocked*boolean

The shop no longer takes online bookings from them.

created_at*string

When the shop first saw this customer.

Formatdate-time
email*|null
has_account*boolean

Whether they sign in on the shop's site.

id*string

The customer's id.

Formatuuid
locale*string

The language their mail goes out in.

name*string

As the customer or staff typed it.

no_show_count*integer

How many bookings staff marked as not shown up.

object*string
phone*string

E.164.

postal_code*|null
updated_at*string

When the record last changed.

Formatdate-time
Example request
curl -X PATCH 'https://api.weerom.com/v1/customers/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'Content-Type: application/json' \  -d '{  "blocked": true}'
Example response
{  "blocked": false,  "created_at": "2026-04-11T09:05:22.000Z",  "email": "[email protected]",  "has_account": true,  "id": "5f0c9d3a-7b2e-4c61-8a4d-9e1f3b6c2d75",  "locale": "nl",  "name": "Lotte Peeters",  "no_show_count": 0,  "object": "customer",  "phone": "+32470123456",  "postal_code": "9000",  "updated_at": "2026-11-18T14:02:11.000Z"}

Details

Keys

Write key

Any other kind of key answers 403 key_not_allowed.

What it does

  • Send name, blocked or both. A name is trimmed, and a name that is empty after trimming is ignored.
  • blocked: true stops online bookings from the customer. Bookings they already hold stay. blocked: false lets them book again.
  • A customer change sends no webhook. Read changes with GET /customers?updated_after=....

Errors

Besides 401 for a missing, unknown or removed key, 403 plan_required, 429 rate_limited and 500 internal_error, which every endpoint can answer. Errors has all of them.

StatuscodeWhenWhat to do
400invalid_requestThe body holds nothing to change, or a field is malformed.Send name, blocked or both. param is body when the request held neither.
404not_foundNo object has this id, or the id is not a UUID.Check the id. Ids are UUIDs from a list or from an earlier answer.
409idempotency_mismatchThe Idempotency-Key was used before for a request with another method, path or body.Make a new Idempotency-Key for a new request.
409request_in_progressThe first request with this Idempotency-Key still runs.Wait a second and send the same request with the same key again.