---
search:
  tags:
    - Customers
    - PUT
seo:
  description: >-
    Update a customer. Reference for the PUT /customers/{id} endpoint in the
    Bolder API v2.
sidebar:
  label: Update a customer
  badge: PUT
title: Update a customer
type: openapi-operation
---
`PUT /customers/{id}`

**Request body** (`application/json`, required)

- `email` (string<email>, required) — Contact email address. Used as the unique identifier for find-or-create.
- `name` (string, required) — Full name (first and last).
- `phone_number` (string)
- `company_name` (string) — Company name. Creates or finds a company record automatically.
- `company_id_number` (string) — Company tax/ID number (RUT, DNI, etc.), stored with the company record.
- `tags` (string[]) — Tag names. Replaces all existing tags.
- `opt_in` (boolean) — Whether the contact accepts marketing emails/newsletters.
- `contact_group_id` (integer) — Contact group ID to assign this contact to.
- `salesperson_id` (string) — Shop admin user ID
- `source` (string) — Origin of the contact record. Defaults to \`API\` if omitted on create.
- `custom_data` (object[]) — Custom field values for this contact.

Request body example:

```json
{
  "name": "Janet Smith-Jones",
  "phone_number": "+15559876543"
}
```

**Responses**

- `200` — Customer updated

Response example, 200:

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