SoftSolzSoftSolz
Sign up
HomeAPI GuideAPI ReferenceWidget Tester
appointments

Create an asset.

Create an asset.

POSThttps://app.softsolz.uk/api/v1/services/appointments/assets

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Headers

Authorizationstringrequired

Bearer token: `Bearer sk_live_...` (or `sk_test_...` for sandbox). A login token will not work here.

Idempotency-Keystring

Optional idempotency key for safe retries.

Body Params

namestringrequired

Display name.

kindstringrequired

Your own category, for example vehicle, property, machine, or animal.

customer_idinteger

Customer this belongs to.

parent_asset_idinteger

Parent asset, so a building can contain rooms.

identifierstring

Registration, serial, or reference.

addressobject

Street address and optional coordinates.

custom_fieldsobject

Your own extra fields, keyed by the definitions in workspace settings.

is_activeboolean

Whether this record is in use.

Response

Response Body

idstringUnique identifier.
customer_idstring | nullCustomer this belongs to.
parent_asset_idstring | nullParent asset, so a building can contain rooms.
kindstringYour own word for the thing a visit is about, for example vehicle or property.
namestringDisplay name.
identifierstring | nullRegistration, serial, or reference.
addressobject | nullStreet address and optional coordinates.
custom_fieldsobjectYour own extra fields, keyed by the definitions in workspace settings.
is_activebooleanWhether this record is in use.
created_atstringWhen the record was created.
updated_atstringWhen the record was last changed. Round-trip as expected_updated_at to guard against stale writes.

Request

curl --request POST \
  --url https://app.softsolz.uk/api/v1/services/appointments/assets \
  --header 'Authorization: Bearer sk_live_your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Worcester Bosch 8000",
  "kind": "boiler"
}'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 201

{
  "data": {
    "id": "12",
    "customer_id": "88",
    "parent_asset_id": "your-parent-asset-id",
    "kind": "boiler",
    "name": "Worcester Bosch 8000",
    "identifier": "your-identifier",
    "address": {},
    "custom_fields": {},
    "is_active": true,
    "created_at": "2026-01-01T09:00:00.000Z",
    "updated_at": "2026-01-01T09:00:00.000Z"
  }
}