Create an IT asset

POST

/it/assets

POST

/rest/it/assets

$ curl -X POST https://api.letsdeel.com/rest/it/assets \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "data": {
>     "name": "MacBook Pro 16",
>     "brand": "Apple",
>     "grade": "A",
>     "category": "LAPTOP",
>     "location": "WITH_USER",
>     "purchase_date": "2025-08-08",
>     "serial_number": "C02XXXXXX",
>     "end_of_life_on": "2028-08-08",
>     "purchase_value": {
>       "amount": "1999.99",
>       "currency": "EUR"
>     },
>     "specifications": [
>       {
>         "name": "STORAGE",
>         "value": "512 GB"
>       }
>     ],
>     "hris_profile_id": "550e8400-e29b-41d4-a716-446655440000",
>     "keyboard_layout": "US_ENGLISH_QWERTY",
>     "operating_system": "MACOS",
>     "storage_location_id": "550e8400-e29b-41d4-a716-446655440000"
>   }
> }'

1 {
2   "data": {
3     "id": "550e8400-e29b-41d4-a716-446655440000",
4     "grade": "A",
5     "status": "ACTIVE",
6     "product": {
7       "id": "550e8400-e29b-41d4-a716-446655440000",
8       "name": "MacBook Pro",
9       "brand": "Apple",
10       "category": "LAPTOP",
11       "specifications": [
12         {
13           "name": "processor",
14           "value": "M1 Pro"
15         }
16       ]
17     },
18     "location": "WITH_USER",
19     "ownership": {
20       "name": "Deel",
21       "type": "DEEL"
22     },
23     "public_id": "ITM-550E8400",
24     "created_at": "2025-08-08T09:49:01.000Z",
25     "updated_at": "2025-08-08T09:49:01.000Z",
26     "assigned_user": {
27       "emails": [
28         "bruce.wayne@wayne-enterprise.com",
29         "batman@gotham.com"
30       ],
31       "address": {
32         "id": "550e8400-e29b-41d4-a716-446655440000",
33         "city": "Gotham",
34         "type": "DELIVERY",
35         "line1": "1007 Mountain Drive",
36         "line2": "Stately Wayne Manor",
37         "state": "New Jersey",
38         "country": "US",
39         "is_valid": true,
40         "post_code": "12345",
41         "phone_number": "+1-212-456-7890",
42         "date_of_birth": "1997-12-18",
43         "tax_id_number": "BAT123456",
44         "passport_number": "P123456789",
45         "delivery_instructions": "Use the Bat-Signal if urgent"
46       },
47       "last_name": "Wayne",
48       "first_name": "Bruce",
49       "hris_profile_id": "550e8400-e29b-41d4-a716-446655440000"
50     },
51     "purchase_date": "2025-08-08",
52     "serial_number": "SN123456",
53     "purchase_value": {
54       "amount": "1999.99",
55       "currency": "EUR"
56     },
57     "assigned_warehouse": {
58       "id": "550e8400-e29b-41d4-a716-446655440000",
59       "name": "Batcave Warehouse",
60       "address": {
61         "id": "550e8400-e29b-41d4-a716-446655440000",
62         "city": "Gotham",
63         "type": "DELIVERY",
64         "line1": "1007 Mountain Drive",
65         "line2": "Stately Wayne Manor",
66         "state": "New Jersey",
67         "country": "US",
68         "is_valid": true,
69         "post_code": "12345",
70         "phone_number": "+1-212-456-7890",
71         "date_of_birth": "1997-12-18",
72         "tax_id_number": "BAT123456",
73         "passport_number": "P123456789",
74         "delivery_instructions": "Use the Bat-Signal if urgent"
75       },
76       "ownership": "DEEL",
77       "public_id": "WRH-550E8400",
78       "warehouse_type": "DEEL"
79     }
80   }
81 }

Creates a new IT asset in your organization. The asset is either assigned to a worker (WITH_USER) or stored at one of your organization warehouses (AT_WAREHOUSE). A product and product variant are created behind the scenes for this asset. Device categories (laptops, desktops, mobile devices, tablets) require a serial number, and require an operating system when the category supports one.

Token scopes: it-assets:write

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

$ curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.deel.training/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Request

Asset to create

dataobjectRequired

Response

Created

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

500

Internal Server Error

$	curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>	-H 'Authorization: Bearer YOUR-TOKEN-HERE'