Update a customer

PUT/customers/{id}

Authorization

AuthorizationBearer token (JWT) · headerrequired

Path parameters

idintegerrequired

Request body

requiredapplication/json

emailstring<email>required

Contact email address. Used as the unique identifier for find-or-create.

namestringrequired

Full name (first and last).

phone_numberstring

company_namestring

Company name. Creates or finds a company record automatically.

company_id_numberstring

Company tax/ID number (RUT, DNI, etc.), stored with the company record.

tagsstring[]

Tag names. Replaces all existing tags.

opt_inboolean

Whether the contact accepts marketing emails/newsletters.

contact_group_idinteger

Contact group ID to assign this contact to.

salesperson_idstring

Shop admin user ID

sourcestring

Origin of the contact record. Defaults to API if omitted on create.

Allowed:signup-formregister-formcontact-formcheckout

custom_dataobject[]

Custom field values for this contact.

Show properties

Array of object

keystring

Field key (slug)

field_idinteger

Field definition ID (optional alternative to key)

valueany

Field value

Responses

200

Customer updated

_linksHalLinks

idinteger

shop_idinteger

emailstring

namestring

Full name (first and last)

phone_numberstring

phone_validatedboolean

validation_methodstring

company_namestring

company_id_numberstring

Company tax/ID number (RUT, DNI, etc.), formatted

company_activity_codestring

customer_statusstring

Customer account status.

Allowed:publicprivatepending

opt_inboolean

Whether the contact has opted in to marketing emails.

sourcestring

last_logged_onstring<date-time>

last_ip_addressstring

has_passwordboolean

total_spentinteger

In cents

available_orders_countinteger

salesperson_idinteger

favorite_product_idsinteger[]

used_promotion_idsinteger[]

tagsstring[]

created_onstring<date-time>

updated_onstring<date-time>

_embeddedobject

Show properties

contact_groupobject

Present when the contact belongs to a group

addressesAddress[]

Show properties

Array of Address

streetstring

street_2string

locality_namestring

region_namestring

country_namestring

postal_codestring

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (JWT)Remember on this deviceInclude my values in samples

Parameters

idpath*

Bodyapplication/json

Request body

Request

curl -X PUT 'https://api.onbolder.com/v2/customers/0' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Janet Smith-Jones",
  "phone_number": "+15559876543"
}'

const response = await fetch("https://api.onbolder.com/v2/customers/0", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"name\": \"Janet Smith-Jones\",\n  \"phone_number\": \"+15559876543\"\n}"
});

import requests

response = requests.put(
    "https://api.onbolder.com/v2/customers/0",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"name\": \"Janet Smith-Jones\",\n  \"phone_number\": \"+15559876543\"\n}",
)

Response

{
  "id": 3001,
  "email": "jane@example.com",
  "name": "Janet Smith-Jones",
  "phone_number": "+15559876543",
  "_links": {
    "self": {
      "href": "https://api.onbolder.com/v2/customers/3001"
    }
  }
}