CareTend APIs

Creates one or more equipment assets in a single transactional batch.

post
https://integrationhub.wellsky.io/commands/v4/assets

Supports two modes — explicit serial numbers (SerialNumbers) or auto-generation
(AutoGenSerialNumbers + Prefix + StartingNumber + NumberOfAssetsToAdd

  • optional Padding). Maximum 200 assets per request. AssetNumber is not supported on
    Create — set asset numbers later via the PATCH endpoint.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

The requested API version

Body Params

The create request body.

Request to create one or more equipment assets.
Supply either SerialNumbers (explicit list) OR the auto-generation fields
(AutoGenSerialNumbers + Prefix + StartingNumber + NumberOfAssetsToAdd + optional Padding) — never both.

int64
required
≥ 1

The Equipment Id this asset belongs to. Required.

serialNumbers
array of strings | null

Explicit list of serial numbers to create. Mutually exclusive with the auto-gen fields.
Maximum 200 per request.

serialNumbers
boolean

Set to true to auto-generate serial numbers using Prefix + StartingNumber +
NumberOfAssetsToAdd + Padding. Mutually exclusive with SerialNumbers.

string | null

Optional. Concatenated verbatim to the front of each generated serial number.
The system does NOT add a separator — include any desired separator in the prefix
itself (e.g., 'abc-' produces 'abc-0078'; 'TEST' produces 'TEST2').
Trimmed of whitespace; null/empty allowed.

int32 | null

Required when AutoGenSerialNumbers=true. Must be ≥ 0.

int32 | null
1 to 200

Required when AutoGenSerialNumbers=true. Must be greater than 0 and ≤ 200.

int32 | null
1 to 20

Optional. Specifies the minimum digit width for zero-padding the numeric portion.
Use this only when leading zeros are desired (e.g., padding=4 with startingNumber=78
produces '0078'). Omit (or set to 1) for no padding. This is a minimum width — if
the natural number exceeds it, the natural digits are preserved; padding never truncates.

int64
required
≥ 1

The Location to assign newly-created assets to. Required.

int32
required
1 to 2147483647

The OwnershipStatus Id (e.g., 1 = Own, 2 = Rent). Required.

string | null

Optional lot number. Recorded into AssetLotHistory if Equipment.LogLots is true.

date-time | null

The lot expiration date in UTC. Date-only — any time component will be discarded server-side.

date-time | null

The DOT certification expiration date in UTC. Date-only — any time component will be discarded server-side.

string | null

Optional notes about the assets.

date-time | null

The purchase date of the asset in UTC. Date-only — any time component will be discarded server-side.

double | null
≥ 0

Optional. Acquisition cost per asset. Must be non-negative.

string | null

Optional Unique Device Identifier (UDI).

string | null

Optional username of the person creating the asset.
If provided, must reference an active user. If omitted, defaults to the system integration user.

Headers
string
enum
Defaults to application/json-patch+json

Generated from available request content types

Allowed:
Responses

Updated 3 days ago

Did this page help you?
Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 days ago

Did this page help you?