/shifts Permission level: 3

post/shifts

Request

  • Base URL
    https://www.humanity.com/api/v2
  • Auth
    API key in query parameter access_token

Request body application/x-www-form-urlencoded

start_timestring required
end_timestring required
start_datestring required
end_datestring required
scheduleinteger required
employee_idstring

A comma-separated employee IDs which will be assigned to a shift

typeinteger

0 -> Standard, 1 -> Open

neededinteger
notesstring
titlestring
confirmedstring

0 -> Not Confirmed; 1 -> Confirmed

locationinteger

Remote Location id

Response

200

statusinteger
tokenstring

Example response

{
  "status": 1,
  "data": {
    "id": 321867317,
    "created": 1472136865,
    "edited": 1472136865,
    "schedule": 1321635,
    "working": 1,
    "user": 2736727,
    "start_date": {
      "id": 2675,
      "month": 8,
      "day": 25,
      "wday": 4,
      "year": 2016,
      "weekday": "Thu",
      "mname": "Aug",
      "week": 34,
      "dayid": 5,
      "timeid": 37,
      "timeid_exact": 37,
      "formatted": "Aug 25, 2016",
      "time": "9:00am",
      "timestamp": 1472108400,
      "hours": 9,
      "date": "2016-08-25 09:00:00",
      "day_of_year": "237",
      "week_adjusted": 34,
      "sp_wday": 5
    },
    "end_date": {
      "id": 2675,
      "month": 8,
      "day": 25,
      "wday": 4,
      "year": 2016,
      "weekday": "Thu",
      "mname": "Aug",
      "week": 34,
      "dayid": 5,
      "timeid": 69,
      "timeid_exact": 69,
      "formatted": "Aug 25, 2016",
      "time": "5:00pm",
      "timestamp": 1472137200,
      "hours": 17,
      "date": "2016-08-25 17:00:00",
      "day_of_year": "237",
      "week_adjusted": 34,
      "sp_wday": 5
    },
    "length": 8,
    "start_timestamp": "2016-08-25 09:00:00",
    "end_timestamp": "2016-08-25 17:00:00",
    "perms": "2",
    "paidtime": 8,
    "start_time": {
      "id": 37,
      "time": "9:00am"
    },
    "end_time": {
      "id": 69,
      "time": "5:00pm"
    },
    "schedule_name": "Waiter",
    "schedule_color": 10,
    "employees": [
      {
        "id": "2744092",
        "name": "Derrick Arnold",
        "avatar": "0",
        "status": "1",
        "last_active": "0",
        "ratecard": "0"
      }
    ],
    "cost": {
      "staff": 1,
      "hours": 8
    },
    "staff": {
      "scheduled": [
        [
          "2744092"
        ]
      ]
    },
    "break": 8
  },
  "token": "xxxxxxx"
}

Changes