Create Asset - FlexPortal

Create an asset

curl --request POST \
  --url https://api-eu.flexportal.io/v1/assets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Tenant-ID: <tenant-id>' \
  --data '
{
  "serialNumber": "C02ZN1ABCD12",
  "sku": "MACBOOK-PRO-16-M3-A",
  "productName": "MacBook Pro 16\" M3 Pro - Grade A",
  "status": "available",
  "location": "Warehouse A - Shelf 12",
  "notes": "Received from supplier 2025-01-15"
}
'

{
  "success": true,
  "message": "<string>",
  "asset": {
    "serialNumber": "<string>",
    "tenantId": "<string>",
    "sku": "<string>",
    "productName": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "productId": "<string>",
    "productImageUrl": "<string>",
    "variantId": "<string>",
    "location": "<string>",
    "customerId": "<string>",
    "rentalId": "<string>",
    "notes": "<string>"
  }
}

POST

assets

Create an asset

curl --request POST \
  --url https://api-eu.flexportal.io/v1/assets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Tenant-ID: <tenant-id>' \
  --data '
{
  "serialNumber": "C02ZN1ABCD12",
  "sku": "MACBOOK-PRO-16-M3-A",
  "productName": "MacBook Pro 16\" M3 Pro - Grade A",
  "status": "available",
  "location": "Warehouse A - Shelf 12",
  "notes": "Received from supplier 2025-01-15"
}
'

{
  "success": true,
  "message": "<string>",
  "asset": {
    "serialNumber": "<string>",
    "tenantId": "<string>",
    "sku": "<string>",
    "productName": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "productId": "<string>",
    "productImageUrl": "<string>",
    "variantId": "<string>",
    "location": "<string>",
    "customerId": "<string>",
    "rentalId": "<string>",
    "notes": "<string>"
  }
}

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

Bulk Import

Add multiple assets from inventory spreadsheets

Returns Processing

Re-register returned/refurbished assets

Request Fields

Field	Required	Description
`serialNumber`	Yes	Unique identifier (manufacturer SN or your own)
`sku`	Yes	Product variant SKU (must exist in catalog)
`acquisitionCost`	No	Your cost to acquire (used for cost recovery)
`acquisitionDate`	No	When acquired (default: today)
`location`	No	Physical location (warehouse name, etc.)
`condition`	No	Condition notes
`notes`	No	Additional notes

Minimal Example

{
  "serialNumber": "SN123456789",
  "sku": "MACBOOK-PRO-16-M3-18GB-SILVER"
}

Complete Example

{
  "serialNumber": "C02ZX1Y2MD6T",
  "sku": "MACBOOK-PRO-16-M3-18GB-SILVER",
  "acquisitionCost": 1750.00,
  "acquisitionDate": "2025-01-15",
  "location": "Amsterdam Warehouse",
  "condition": "New in box",
  "notes": "Batch order #2025-001"
}

Serial Number Best Practices

Choose a consistent serial number strategy:

Approach	Example	Pros
Manufacturer SN	`C02ZX1Y2MD6T`	Matches physical label
Your numbering	`FP-2025-00001`	Predictable, sequential
Combined	`APPLE-C02ZX1Y2MD6T`	Searchable by manufacturer

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:

Verify the SKU exists using List Variants
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: Asset with cost tracking
await createAsset({
  serialNumber: 'SN123456789',
  sku: 'MACBOOK-PRO-16-M3-18GB-SILVER',
  acquisitionCost: 1750.00  // What you paid for this unit
});

Example: Bulk Asset Creation

async function importAssets(assetList) {
  const results = { created: 0, errors: [] };

  for (const asset of assetList) {
    try {
      await createAsset({
        serialNumber: asset.serialNumber,
        sku: asset.sku,
        acquisitionCost: asset.cost,
        location: asset.warehouse
      });
      results.created++;
    } catch (error) {
      results.errors.push({
        serialNumber: asset.serialNumber,
        error: error.message
      });
    }
  }

  return results;
}

Error Handling

Error Code	Cause	Solution
`ASSET_EXISTS`	Serial number already in use	Use unique serial number
`VARIANT_NOT_FOUND`	SKU doesn’t exist	Create product variant first
`VARIANT_INACTIVE`	SKU is deactivated	Reactivate variant or use different SKU
`VALIDATION_ERROR`	Missing required fields	Check serial number and SKU

List Assets - View all assets
Get Asset - Verify asset was created
List Variants - Find valid SKUs
Create Subscription - Use asset in subscription

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

Show child attributes

Get Asset Update Asset

​Overview

​Common Use Cases

Receiving Inventory

Warehouse Operations

Bulk Import

Returns Processing

​Request Fields

​Minimal Example

​Complete Example

​Serial Number Best Practices

​SKU Validation

​Acquisition Cost Importance

​Example: Bulk Asset Creation

​Error Handling

​Related Endpoints

Authorizations

Headers

Body

Response

Overview

Common Use Cases

Request Fields

Minimal Example

Complete Example

Serial Number Best Practices

SKU Validation

Acquisition Cost Importance

Example: Bulk Asset Creation

Error Handling

Related Endpoints