Create a client
This endpoint is documented ahead of its release and is not available yet.
POST/clients
Creates the client the way the desktop does: the member of the Clients dimension, its
backing object and the company contact linked to it (contact). With upsert_by (a
custom property code acting as the external key) an existing client carrying that value
is answered with 200 instead of creating a duplicate. Requires
can_manage_dimension_members.
Request
Responses
- 200
- 201
- 401
- 403
- 409
- 422
An existing client matched upsert_by; nothing was created.
Created
Missing, invalid or expired token, or no contact matches it.
Authenticated, but not allowed.
The request conflicts with the current state. code says how:
idempotency_key_reuse / request_in_progress (the Idempotency-Key header),
invoiced (an expense or time entry on an invoice cannot change), already_paused,
not_paused, not_running (the timer), deleted.
Invalid input. details maps each field to a reason the client can switch on
(required, invalid, not_found, conflict, unsupported, …; see each operation);
_: rejected is a refusal by EVX Software's own save, with its message.