Skip to main content
POST
Create an asset

Overview

Add a new physical asset to your inventory. Assets are tracked by serial number and linked to product variants via SKU. Before you can create subscriptions, you need assets in your inventory.
The serial number becomes the asset’s unique identifier. Use manufacturer serial numbers, asset tags, or your own numbering system—just ensure each is unique.

Common Use Cases

Receiving Inventory

Add assets as they arrive from suppliers

Warehouse Operations

Register assets during intake and inspection

Bulk Import

Add multiple assets from inventory spreadsheets

Returns Processing

Re-register returned/refurbished assets

Request Fields

Minimal Example

Complete Example

Serial Number Best Practices

Choose a consistent serial number strategy:
Serial numbers must be unique within your tenant. Attempting to create an asset with an existing serial number returns a 409 Conflict error.

SKU Validation

The SKU must match an active product variant. Before creating assets:
  1. Verify the SKU exists using List Variants
  2. Ensure the variant is active, not inactive

Acquisition Cost Importance

The acquisitionCost is crucial for cost recovery calculations:
  • If provided: Used for profitability tracking on subscriptions
  • If omitted: System may use variant’s default acquisition cost

Example: Bulk Asset Creation

Error Handling

Authorizations

Authorization
string
header
required

API key obtained from FlexPortal dashboard

Headers

Tenant-ID
string
required

Your tenant identifier

Body

application/json
serialNumber
string
required
Minimum string length: 1
tenantId
string
required
Minimum string length: 1
sku
string
required
Minimum string length: 1
productName
string
required
Minimum string length: 1
status
enum<string>
required
Available options:
available,
rented_out,
returned,
sold,
unavailable
createdAt
any
required
updatedAt
any
required
productId
string
productImageUrl
string<uri>
variantId
string
location
string
customerId
string
rentalId
string
notes
string

Response

Asset created

success
boolean
required
message
string
required
asset
object
required