Customers

Create a customer

POST/customers

Headers

Idempotency-Keystring · max 255required

Client-generated key that identifies one write for 24 hours. Reuse it only when retrying the same method, path, query, and body.

Body

namestring · max 200required

emailstring · email · nullable

contactPersonstring · nullable

addressobject · nullable

vatNumberstring · nullable

registrationNumberstring · nullable

Responses

201

Created. Created.

400

Bad request. Malformed request.

401

Unauthorized. Missing, invalid, revoked, or expired API key.

403

Forbidden. The API key lacks a required scope or the creator lacks a required permission.

409

Conflict. State conflict.

Request

curl -X POST https://api.neno.build/public/v1/customers \
  -H "Authorization: Bearer $NENO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string"
  }'

201 Created · application/json

{
  "name": "string",
  "email": "[email protected]",
  "contactPerson": null,
  "address": {
    "line1": "string",
    "line2": "string",
    "city": "string",
    "postalCode": "string",
    "countryCode": "string"
  },
  "vatNumber": null,
  "registrationNumber": null,
  "id": "9b2f6c1e-4a7d-4f0e-8c3b-2d51e7a0f4c9",
  "createdAt": "2026-09-24T09:30:00Z",
  "updatedAt": "2026-09-24T09:30:00Z"
}