Create a customer

POST

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

POST

/cpo/customers

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.cpo.customers.create({
        name: "Amsterdam Parking BV",
        type: "SITE_OWNER",
        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"
  }
}

Add a site owner, fleet, partner or other customer. owner_id must be one of your customers.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

namestringRequired1-255 characters

typeenum or nullOptionalDefaults to SITE_OWNER

What kind of customer this is.

Allowed values:

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 created object.

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

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