Create supplier product
Creates a supplier product referencing an existing supplier plant by UUID.
The authenticated manufacturer is inferred from the API key. LCA impact
data is sourced from the linked epd_id (if provided) or from Emidat’s
background datasets behind material_type — the elementary_id for an
emidat-elementary, or the composite’s materials for a
custom-composite.
Idempotent create — a replay of the same Idempotency-Key returns the
original response (200); otherwise a new supplier product 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
Name of the supplier product.
"Portland Cement CEM I 42.5 R"
What this supplier product is made of — either an Emidat elementary or
a composite you defined. Discriminated by category.
- Option 1
- Option 2
The plant's Emidat UUID.
Your own code for this supplier product (e.g. from your ERP). Optional.
When provided it is unique among your active supplier products —
creating another with the same code returns 409 (see
External IDs).
"COMP-001"
UUID of the supplier plant. Create via POST /v2/supplier-plants. Optional.
Transport distances from the supplier plant to your gate, one per modality (km). Optional.
Optional EPD UUID to link to this supplier product, if one was identified during setup.
Hazardous substances in this material, each by CAS number and mass share. Optional; defaults to none.
Expected service life in years. Optional.
Share of secondary (recycled) content, 0–100. Optional.
Moisture content as a percentage. Optional.
Response
Returned unchanged — an Idempotency-Key replay.
Your own code for this supplier product, as provided on creation.
"Portland Cement CEM I 42.5 R"
What this supplier product is made of — an Emidat elementary or a
composite, by reference. Discriminated by category. Resolve a
composite_id with GET /v2/composites/{id}.
- Option 1
- Option 2
The plant's Emidat UUID.
UUID of the supplier plant this material is sourced from. Resolve it
with GET /v2/supplier-plants/{id}.
Transport distances from the supplier plant to your gate, one per modality (km).
Hazardous substances in this material, each by CAS number and mass share.
M, M2, M3, KG, T, L, KWH, MJ, UNIT, METRIC TON*KM "KG"
Characterized cradle-to-gate impacts of this supplier product per kg. Null until computed.
The transport portion of this product's impacts per kg. Null until computed.
Background datasets used to compute the impacts.