Create an IT order

POST

/it/orders

POST

/rest/it/orders

curl -X POST https://api.letsdeel.com/rest/it/orders \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "data": {
    "variants": [
      {
        "variant_id": "2f4e7ab1-9d3c-4b1f-9e34-6dfb0d6a12ab",
        "contract_setting": {
          "addons": [
            {
              "addon_id": "5c1a7d3e-8b2f-4a6c-9e1d-3f5b7a8c9d0e"
            }
          ],
          "acquisition_type": "RENTAL"
        }
      }
    ],
    "destination": {
      "assign_to": "USER",
      "hris_profile_id": "6ad9f0f0-6e2a-4f9a-a3f8-2a9f5f2d6b71",
      "delivery_address": {
        "country": "GB"
      }
    },
    "is_express_delivery_requested": false
  }
}'

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "user": {
      "emails": [
        "bruce.wayne@wayne-enterprise.com",
        "batman@gotham.com"
      ],
      "address": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "city": "Gotham",
        "type": "DELIVERY",
        "line1": "1007 Mountain Drive",
        "line2": "Stately Wayne Manor",
        "state": "New Jersey",
        "country": "US",
        "is_valid": true,
        "post_code": "12345",
        "phone_number": "+1-212-456-7890",
        "date_of_birth": "1997-12-18",
        "tax_id_number": "BAT123456",
        "passport_number": "P123456789",
        "delivery_instructions": "Use the Bat-Signal if urgent"
      },
      "last_name": "Wayne",
      "first_name": "Bruce",
      "hris_profile_id": "550e8400-e29b-41d4-a716-446655440000"
    },
    "status": "REQUESTED",
    "public_id": "ORD-550E8400",
    "created_at": "2025-08-08T09:49:01.000Z",
    "updated_at": "2025-08-08T09:49:01.000Z",
    "order_items": [
      {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "status": "SHIPPED",
        "product": {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "name": "MacBook Pro",
          "brand": "Apple",
          "category": "LAPTOP"
        },
        "created_at": "2025-08-08T09:49:01.000Z",
        "is_approved": false,
        "pricing_details": {
          "asset_price": {
            "amount": "1999.99",
            "currency": "EUR"
          },
          "storefront_fee": {
            "amount": "1999.99",
            "currency": "EUR"
          },
          "acquisition_type": "PURCHASE"
        },
        "is_express_delivery_requested": true
      }
    ],
    "delivery_address": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "city": "Gotham",
      "type": "DELIVERY",
      "line1": "1007 Mountain Drive",
      "line2": "Stately Wayne Manor",
      "state": "New Jersey",
      "country": "US",
      "is_valid": true,
      "post_code": "12345",
      "phone_number": "+1-212-456-7890",
      "date_of_birth": "1997-12-18",
      "tax_id_number": "BAT123456",
      "passport_number": "P123456789",
      "delivery_instructions": "Use the Bat-Signal if urgent"
    }
  }
}

Creates a pre-approved IT equipment order for a worker, so you can raise it from your own onboarding or procurement workflow. Set destination.assign_to to USER and identify the worker with destination.hris_profile_id.

Token scopes: it-orders: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.letsdeel.com/rest/v2/contracts' \
  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

AuthorizationBearer

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

Request

Order to create

dataobjectRequired

Response

Created

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

500

Internal Server Error