How do I add components to a work order through the API without a BOM?
Last updated: November 13, 2026
Use this when each job has its own materials and you don't want to keep a saved BOM for every one.
Before you start: adding and removing work order components through the API has to be turned on for your account. If it isn’t, the API returns 422 with “Adding components to a work order is not enabled for this tenant.” Contact support to turn it on.
Add components when you create the work order
Send a bom_items list on the create work order request, with no bom_id. Each line takes:
product_id(required)quantity(required, greater than 0, per finished unit)uom_id(optional)supply_mode(optional)
Add components to an existing work order
GET /work-orders/{id}/bom-itemslists the components.POST /work-orders/{id}/bom-itemswith abom_itemslist adds components.DELETE /work-orders/{id}/bom-items/{rowId}removes one.
This works only while the work order is draft or planned. Updating a work order with PUT does not accept components. Use the routes above.
Rules the API enforces
A product can only be listed once.
A work order can't consume the product it produces.
A product already on the work order or its BOM can't be added again.
A product used in one of the work order's sub-assemblies can't be added.
uom_id, if you send it, must match the product’s own unit.
Service work orders can’t take components.
A component that is built (assembly or work order supply) can’t be removed.
Removing a component that came from the BOM sets its quantity to 0. Removing one you added deletes it.
A component that would need to be built (a sub work order or assembly order supply method) can't be added. Send a supply method that sources it instead.
Added components are treated like BOM lines when you generate transfer orders and when the work order is completed.