---
title: "Update customer"
method: PUT
path: "/customers/{id}"
tags: ["Customer Endpoints"]
---

# Update customer

`PUT /customers/{id}`

Update an existing customer's details.

## Path parameters

- `id` integer, required

## Headers

- `Authorization` string, required

## Request body

- object
  - `customer` CustomerCreateBody
    - `name` string, required — The customers given full name
    - `email` string, required — The customers email address
    - `mobile` string — The customers mobile phone number
    - `reminders_opt_in` boolean — Whether this customer wants to receive reminders
    - `mailing_list_opt_in` boolean — Whether this customer wants to be on the mailing list

## Response `200`

Customer updated

- Customer
  - `id` integer — Use to identify the customer in other API calls
  - `name` string — The customers given full name
  - `email` string — The customers email address
  - `mobile` string — The customers mobile phone number
  - `avatar` string — The customers avatar image URL, if any
  - `credit_balance` integer — The customers current credit balance in cents/pence/units This cannot be changed via the API
  - `status` 'unregistered' | 'invited' | 'registered' | 'banned' | 'behind_payment' — The status of the customer `unregistered`: The customer has booked but not registered an account `invited`: The customer has been invited to register an account `registered`: The customer has registered an account `banned`: The customer has been marked as banned from booking (and will not be able to book) `behind_payment`: The customer has been marked as behind on payments (and will not be able to book)
  - `reminders_opt_in` boolean — Whether this customer wants to receive reminders
  - `mailing_list_opt_in` boolean — Whether this customer wants to be on the mailing list
  - `signed_up` boolean — Whether the customer has signed up
  - `signed_up_at` integer — Unix timestamp from epoch - when the customer signed up
  - `regular_bookings_count` union — The number of regular bookings the customer has made. Note: may return boolean `false` instead of `0` when the customer has no regular bookings.
    - integer
    - boolean
  - `bookings_count` integer — The number of bookings the customer has made
  - `created_at` integer — Unix timestamp from epoch - when the customer was created
  - `updated_at` integer — Unix timestamp from epoch - when the customer was last updated
  - `last_booking_at` integer — Unix timestamp from epoch - when the customer last booked
  - `regular_bookings` object[] — The customer's regular bookings
    - `name` string
    - `id` integer
  - `bands` ShortGroup[]
    - `name` string, required — The name of the group
    - `code` string, required — The code of the group - used internally by Jammed
    - `number_of_members` integer — The number of members in the group (only present in full group responses)
    - `number` integer, nullable — The number of members in the group (present in customer band responses)
    - `booking_count` integer — The number of bookings for this group
  - `address` CustomerBillingAddress — The customer's billing address, as captured during checkout. This is `null` when the customer has not provided a billing address.
    - `company` string, nullable — The company name on the billing address, if any
    - `address_1` string, nullable — The first line of the billing address
    - `address_2` string, nullable — The second line of the billing address, if any
    - `town` string, nullable — The town or city of the billing address
    - `state` string, nullable — The state, county or region of the billing address, if any
    - `postcode` string, nullable — The postal or ZIP code of the billing address
    - `country` string, nullable — The ISO 3166-1 alpha-2 country code of the billing address, e.g. `GB` or `US`
    - `formatted_address` string, nullable — The full billing address as a single comma-separated string, with the country name expanded (e.g. `United States of America`)

---

[API](https://skmtc.net/jammed-org/apis/jammed-bookings-api.md) · [All operations](https://skmtc.net/jammed-org/apis/jammed-bookings-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jammed-org/jammed-bookings-api/versions/3fc6a6f91b06/schema)