Create supplier company
Creates a supplier company at the given plant — the organization a supplier plant belongs to.
Idempotent create — a replay of the same Idempotency-Key returns the
original response (200); otherwise a new supplier company is created
(201). Your external_id must be unique: reusing one returns 409. See
External IDs.
Authorizations
Per-manufacturer API key in the X-API-Key header, format
emidat-{key_id}-{secret} where key_id is a random public handle.
Issued by an owner in the Emidat
dashboard; carries its own permission scopes, optional plant
restrictions, and optional expiry. A revoked, expired, or unknown key
returns 401. See the Authentication guide for details.
Headers
Optional client-generated key (e.g. a UUID) that makes a create
idempotent — the only mechanism that does so. A replay carrying the same
key returns the original response unchanged (200); reusing a key with a
different request body is rejected with 409. Keys are scoped to your
manufacturer and retained for 6h. See External IDs.
Body
UUID of the plant this supplier company belongs to.
Name of the supplier company. Must be unique case-insensitively among
active supplier companies at this plant; duplicates return 409.
"Acme Materials GmbH"
Your own code for this supplier company. Optional. When provided it is
unique among your active supplier companies — creating another with the
same code returns 409 (see External IDs).
"SUPPLIER-ACME"
Response
Returned unchanged — an Idempotency-Key replay.
UUID of the supplier company.
Your own code for this supplier company. null when none is set.
UUID of the plant this supplier company belongs to.
"Acme Materials GmbH"