---
title: "Update Customer"
method: PUT
path: "/v2/tms-api/customers/{external_reference_id}"
tags: ["TMS API", "TMS API - Customers"]
---

# Update Customer

`PUT /v2/tms-api/customers/{external_reference_id}`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v2/tms-api/customers/{external_reference_id}`
- Auth: none declared

Update an existing customer.

## Path parameters

- `external_reference_id` string, required

## Headers

- `X-API-Key` string, nullable: API key for authentication

## Request body

- CustomerUpdate: Schema for updating a customer. All fields are optional.
  - `name` string, nullable: Customer name
  - `reference_number` string, nullable: Additional reference number
  - `domain` string, nullable: Customer domain/website
  - `phone` string, nullable: Phone number
  - `is_active` boolean, nullable: Is the customer active
  - `customer_type` string, nullable: Customer type/category

## Response `200`

Successful Response

- CustomerResponse: Response schema for a customer.
  - `id` string, required: Internal Mentium ID
  - `external_reference_id` string, required: External reference ID from your system
  - `name` string, required: Customer name
  - `reference_number` string, nullable: Additional reference
  - `domain` string, nullable: Customer domain/website
  - `phone` string, nullable: Phone number
  - `is_active` boolean, required: Is the customer active
  - `customer_type` string, nullable: Customer type/category
  - `created_at` string, date-time, required: Creation timestamp
  - `updated_at` string, date-time, required: Last update timestamp

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mentium/apis/mentium-api.md) - [All operations](https://skmtc.dev/mentium/apis/mentium-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mentium/apis/mentium-api/revisions/b4ed8e59432e?raw)