Create shifts | Deel | Documentation

curl -X POST https://api.letsdeel.com/rest/v2/time_tracking/shifts \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "data": {
    "shifts": [
      {
        "shift_type": "REGULAR",
        "date_of_work": "2023-10-01",
        "description": "This is a sample shift description.",
        "external_id": "shift_123d47dewdwe",
        "summary": {
          "total_break_hours": 1,
          "payable_break_hours": 0.5,
          "total_payable_hours": 7.5,
          "shift_duration_hours": 8,
          "shift_rate_external_id": "id1shiftrsate1"
        },
        "payroll_cycle_ref": {
          "date": "2023-10-31T12:00:00.000Z"
        }
      }
    ],
    "contract_id": "35edggp"
  }
}'

{
  "data": [
    {
      "created_at": "2024-02-01T00:00:00.000Z",
      "shift_type": "REGULAR",
      "updated_at": "2024-02-10T00:00:00.000Z",
      "contract_id": "contract-id-456",
      "description": "Night shift at warehouse",
      "external_id": "external-id-123",
      "date_of_work": "2024-02-12",
      "meta": {
        "end": {
          "date": "2024-02-12",
          "time": "16:00",
          "is_rest_day": false,
          "is_public_holiday": false
        },
        "start": {
          "date": "2024-02-12",
          "time": "08:00",
          "is_rest_day": false,
          "is_public_holiday": false
        },
        "breaks": [
          {
            "end": {
              "date": "12:30",
              "time": "12:30"
            },
            "start": {
              "date": "2024-02-12",
              "time": "12:00"
            },
            "is_paid": true
          }
        ],
        "approval_date": "2024-02-11T12:00:00.000Z"
      },
      "summary": {
        "shift_rate_external_id": "shift-rate-id-789",
        "time_unit": "HOUR",
        "time_amount": 8,
        "total_break_hours": 0.5,
        "payable_break_hours": 0.5,
        "total_payable_hours": 7.5,
        "shift_duration_hours": 8
      },
      "payroll_cycle_ref": {
        "date": "2024-02-11T12:00:00.000Z"
      },
      "shift_reference_id": "shift-ref-123"
    }
  ]
}

Creates multiple time tracking shifts for a contract, supporting both regular shift submissions and corrections that adjust hours for previously processed shifts.

Token scopes: time-tracking: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

Request body to create time tracking shifts supporting regular shifts and correction shifts.

dataobjectRequired

Response

Successful operation.

datalist of objects

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error