Skip to main content
A screening is always attached to a product. Create the product first, then create a screening for it.

Create a product

Call POST /v1/products to create the product. The response includes a publicId (e.g. prd_xxxxxxxxxxxx) — save this. You’ll pass it as a path parameter in every subsequent product call, including creating the screening.

Create a screening

Call POST /v1/products/{productId}/screenings using the product publicId from above. The response includes a screening publicId (e.g. scr_xxxxxxxxxxxx) — save this. You’ll use it when adding materials, packaging, and in all other screening-scoped calls.

What to know about the fields

transportLocation takes a location publicId (trl_ prefix). Fetch available locations from GET /v1/locations and use the publicId from that response. If no locations exist yet, see Create a Location first. Several fields only apply to specific product types and can be ignored otherwise:
Product typeRelevant fields
Electrical appliancesenergyOperationalConsumption, energyStandbyConsumption
Lighting productslightSocketType (None, E14, E27, G9), amountOfLightSockets, lightSourceOperationalConsumption, lightSourceStandbyConsumption

Next

Add Materials → or Add Packaging →