Skip to Content
TillorPodręcznik
Customers

Create Customer

Dostęp

Członek organizacji z tym uprawnieniem:

  • customers:write

Klucz API z zakresami potrzebuje też tego uprawnienia w swoich zakresach.

POST
/orgs/{organizationId}/customers

Creates a new customer with the provided data. Optional identityDocumentScanId links an unassigned (pending) identity document scan to the new customer in the same atomic transaction.

Authorization

ApiKeyAuth
headerx-api-key<token>

API key for authentication

Path Parameters

organizationId*string

The ID or slug of the organization

Request Body

application/json
  1. body
firstName*string
Length1 <= length
lastName?string|null
email?|unknown
phone?string
vatNumber?string
identityDocumentScanId?string
customFields?

Response Body

OK

application/json
  1. response
Example Request
curl -X POST 'https://api.tillor.eu/orgs//customers' \  -H 'Content-Type: application/json' \  -d '{  "firstName": "string"}'
Example Response
null

List Customers GET

Lists customers with pagination, filtering, sorting, and includes. Supports virtual fields (terrains, meters, consumption), filtering by id, status, customerType, displayId, and text search.

Get Customer GET

Retrieves a customer by their ID. Supports virtual fields: terrains, meters, consumption (same as list endpoint).