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 new IT equipment order in your organization, already approved. Orders are assigned via assign_to — only USER (delivery to the worker identified by destination.hris_profile_id) is wired end-to-end today; other values are reserved for future bundles. Only organizations on the Pro plan (per-seat tier with an active IT seat contract with paid seats) can create orders; others receive a 409 (organization_not_per_seat or organization_has_no_paid_it_seats).

Token scopes: it-orders:write

Creates a new IT equipment order in your organization, already approved. Orders are assigned via `assign_to` — only `USER` (delivery to the worker identified by `destination.hris_profile_id`) is wired end-to-end today; other values are reserved for future bundles. Only organizations on the Pro plan (per-seat tier with an active IT seat contract with paid seats) can create orders; others receive a 409 (`organization_not_per_seat` or `organization_has_no_paid_it_seats`). **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

## 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.letsdeel.com/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

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