Skip to main content
PUT
/
customer
/
{customer_number}
Create or update customer
curl --request PUT \
  --url https://start.aiotic.ai/customer/{customer_number} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "postal_code": "<string>",
  "city": "<string>",
  "address": "<string>",
  "contact_person": "<string>",
  "phone_number": "<string>",
  "vat_number": "<string>",
  "email": "<string>",
  "coc_number": "<string>",
  "home_page": "<string>"
}
'
{
  "number": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "postal_code": "<string>",
  "city": "<string>",
  "address": "<string>",
  "contact_person": "<string>",
  "phone_number": "<string>",
  "vat_number": "<string>",
  "email": "<string>",
  "coc_number": "<string>",
  "home_page": "<string>",
  "similarity": 123
}

Authorizations

X-API-Key
string
header
required

API key for authentication. Required on all endpoints except /healthcheck. Customer and product endpoints also accept a customer-specific API key.

Path Parameters

customer_number
string
required

Unique customer number (string)

Body

application/json
id
string<uuid> | null

Internal UUID (auto-generated if not provided)

name
string | null

Company name

postal_code
string | null

Postal code

city
string | null

City

address
string | null

Street address

contact_person
string | null

Primary contact person

phone_number
string | null

Phone number

vat_number
string | null

VAT/BTW number

email
string | null

Customer email address

coc_number
string | null

Chamber of Commerce number

home_page
string | null

Company website URL

Response

Customer created or updated

number
string
required

Customer number (external, unique)

id
string<uuid>

Unique customer identifier

name
string | null

Company name

postal_code
string | null

Postal code

city
string | null

City

address
string | null

Street address

contact_person
string | null

Primary contact person

phone_number
string | null

Phone number

vat_number
string | null

VAT/BTW number

email
string | null

Customer email address

coc_number
string | null

Chamber of Commerce number

home_page
string | null

Company website URL

similarity
number<float> | null

Similarity score (only populated in search results, 0.0 to 1.0)