--- search: tags: - Suppliers - POST seo: description: >- Products reference suppliers by ID, so an integration syncing its own… Reference for the POST /api/v1/suppliers endpoint in the Bloomcount Public API API. sidebar: label: Create a supplier badge: POST title: Create a supplier type: openapi-operation --- Products reference suppliers by ID, so an integration syncing its own supplier list calls this before its first product write. Only `name` is required; the contact fields are for whoever places the order. Names are unique on a tenant, so creating one that already exists returns `409 supplier_name_taken` rather than a duplicate. That makes this endpoint safe to call on every sync if you treat that code as "already have it", though holding onto the returned `supplierId` is cheaper. **Errors** - `422 supplier_name_required` — no name, or a blank one. - `409 supplier_name_taken` — another supplier on the tenant already has that name. Requires the `suppliers:write` scope.