Replace a customer

PUT

https://api.ocpplab.io/cpo/customers/:customer_id

PUT

/cpo/customers/:customer_id

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.cpo.customers.replace({
        customer_id: 31,
        name: "Amsterdam Parking BV",
        external_id: "ERP-1042",
        country: "NLD",
        contact_details: {
            email: "ops@parking.example",
        },
        billing_details: {
            vat_number: "NL123456789B01",
        },
    });
}
main();

{
  "id": 31,
  "organization_id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Amsterdam Parking BV",
  "type": "SITE_OWNER",
  "is_taxable_dealer": false,
  "created_at": "2026-09-30T10:00:00Z",
  "updated_at": "2026-09-30T10:00:00Z",
  "external_id": "ERP-1042",
  "country": "NLD",
  "contact_details": {
    "email": "ops@parking.example"
  },
  "billing_details": {
    "vat_number": "NL123456789B01"
  }
}

Every editable field is replaced; fields left out are cleared. The type cannot change, and owner_id must not make the customer its own ancestor.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

customer_idintegerRequired>=1

The customer’s id.

Request

This endpoint expects an object.

namestringRequired1-255 characters

external_idstring or nullOptional<=255 characters

countrystring or nullOptionalformat: "^[A-Z]{3}$"

owner_idinteger or nullOptional>=1

contact_detailsmap from strings to any or nullOptional

billing_detailsmap from strings to any or nullOptional

payout_informationmap from strings to any or nullOptional

settingsmap from strings to any or nullOptional

is_taxable_dealerboolean or nullOptional

Response

The object after the update.

idinteger

organization_idstring

namestring

typeenum or any

is_taxable_dealerboolean

created_atdatetime

updated_atdatetime

external_idstring or nullOptional

countrystring or nullOptional

owner_idinteger or nullOptional

contact_detailsmap from strings to any or nullOptional

billing_detailsmap from strings to any or nullOptional

payout_informationmap from strings to any or nullOptional

settingsmap from strings to any or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error