Update customer

PATCH

/customers/{id}

curl --request PATCH \
  --url https://api.pipevest.com/v1/customers/clx0a1b2c3d4e5f6g7h8i9j0k \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <x-client-id>' \
  --data '{ "firstName": "example", "lastName": "example", "msisdn": "example", "isActive": true, "identificationNumber": "example", "identificationType": "SSN", "referenceId": "example" }'

• Production
• Sandbox (UAT)

Partial update — send only the fields you want to change.

Authorizations

• bearerAuth
• clientId

Parameters

Path Parameters

id

required

string

Example

clx0a1b2c3d4e5f6g7h8i9j0k

Customer identifier (CUID string).

Header Parameters

X-Idempotency-Key

string format: uuid

Idempotency key (UUID) for safely retrying mutating requests. Enforcement is being rolled out during onboarding.

Request Body^required

Media typeapplication/json

All fields optional; nullable fields may be cleared with null.

object

firstName

string

<= 100 characters

lastName

string

<= 100 characters

msisdn

string

nullable /^\d{7,15}$/

isActive

boolean

identificationNumber

string

nullable <= 50 characters

identificationType

string

Allowed values: SSN PASSPORT DRIVER_LICENSE NATIONAL_ID TAX_ID OTHER

referenceId

string

nullable <= 100 characters

Responses

200

Customer updated

Media typeapplication/json

object

message

string

data

object

id

string

organizationId

string

firstName

string

lastName

string

msisdn

string

nullable

isActive

boolean

identificationNumber

string

nullable

identificationType

string

Allowed values: SSN PASSPORT DRIVER_LICENSE NATIONAL_ID TAX_ID OTHER

referenceId

string

nullable

createdAt

string format: date-time

updatedAt

string format: date-time

Example

{
  "message": "Customer updated successfully",
  "data": {
    "id": "clx0a1b2c3d4e5f6g7h8i9j0k",
    "organizationId": "clorgb2c3d4e5f6g7h8i9j0k1",
    "firstName": "John",
    "lastName": "Doe",
    "msisdn": "260971234567",
    "isActive": true,
    "identificationType": "SSN"
  }
}

400

Request failed schema validation

Media typeapplication/json

object

error

string

details

Array<object>

object

field

string

message

string

Example

{
  "error": "Validation failed",
  "details": [
    {
      "field": "firstName",
      "message": "First name is required"
    }
  ]
}

401

Authentication failed

Media typeapplication/json

object

error

string

message

string

Example

{
  "error": "Unauthorized",
  "message": "Invalid organization authentication token"
}

404

Resource not found

Media typeapplication/json

object

error

string

message

string

Example

{
  "error": "Not found",
  "message": "Customer not found"
}