/employees Permission level: 4

post/employees

Request

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

Request body application/x-www-form-urlencoded

namestring
fnamestring
lnamestring
eidstring
statusstring

enum [-1, 0, 1] <br>-1: Disabled<br>0: Not Activated<br>1: Activated

groupstring

enum [2, 3, 4, 5, 6, 7] -> 2: Manager; 3: Supervisor; 4: Scheduler; 5: Employee; 6: Accountant; 7: Schedule Viewer

emailstring
nick_namestring
birth_dayinteger
birth_monthinteger
cell_phonestring
wageinteger
home_phonestring
addressstring
citystring
statestring
job_titlestring
middle_namestring
genderstring

enum['M','F']

zipstring
notesstring
smsgatewayinteger
passwordstring

Minimum 6 characters.

usernamestring

Minimum 3 characters.

send_activationinteger

enum [1] -> 1: Send activation

facebookstring
googlestring
ldapstring
languagestring
skillsstring

Comma-separated array of skill IDs

timezone_idinteger
locationinteger
undertimeinteger
overtimeinteger
daily_overtimeinteger
max_days_rowinteger
pref_shift_autoconfirminteger

enum [-1, 1, -2]

customstring json

A JSON string representing an object with multiple key-value pairs. Key should contain the Custom Field ID, and value the Custom Field content.

positionsstring json

An array of position IDs in JSON format, eg. [747311, 743314]

monthly_overtimeinteger
monthly_undertimeinteger
pref_mtimebshiftsinteger

enum [0, 1, 2, 3, 4, 5, 6, 7, 8, 12, 16, 20, 24, 28, 32, 36, 40, 44, 48]

work_start_datestring date
employee_typeinteger

enum [0, 1, 2, 3, 4, 5, 6] <br> 0 - None <br> 1 - Full Time <br> 2 - Part Time <br> 3 - Seasonal <br> 4 - Temporary <br> 5 - Contractor <br> 6 - Volunteer

pay_typeinteger

enum [0, 1, 2, 3, 4, 5, 6] <br> 0 - None <br> 1 - Hourly <br> 2 - Salary <br> 3 - Commission <br> 4 - Exception Hourly <br> 5 - Daily <br> 6 - Weekly <br> 7 - Monthly <br> 8 - Piece Rate <br> 9 - Contract <br> 10 - Pro Rata

Response

200

statusinteger
tokenstring
errorunknown

Example response

{
  "status": 1,
  "data": {
    "id": "3997029",
    "username": "mikestan",
    "email": "michael.stanley.333@mail.com",
    "realname": "Mike",
    "location": "0",
    "email_setting": "1",
    "notify_with_post": "0",
    "auto_notify": "0",
    "show_smilies": "1",
    "show_img": "1",
    "show_img_sig": "1",
    "show_avatars": "1",
    "show_sig": "1",
    "access_keys": "0",
    "timezone": "314",
    "dst": "0",
    "time_format": "0",
    "date_format": "0",
    "style": "ShiftPlanning",
    "num_posts": "0",
    "registered": "1523636283",
    "registration_ip": "82.117.214.54",
    "last_visit": "0",
    "last_active": "0",
    "pun_bbcode_enabled": "1",
    "pun_bbcode_use_buttons": "1",
    "pun_pm_long_subject": "1",
    "newsletter": "1",
    "email_confirmed": "0",
    "status": "1",
    "deleted": "0",
    "deleted_by": "0",
    "legal_agree": "0",
    "referral": "0",
    "name": "Mike",
    "firstname": "Michael",
    "lastname": "Stanley",
    "nick_name": "Mike",
    "birth_day": "0",
    "birth_month": "0",
    "cellphone_confirmed": "0",
    "last_sms_sent": "0",
    "avatar": {
      "small": "https://d3l54fgzztlejs.cloudfront.net/app/layout/images/no_avatar.png",
      "medium": "https://d3l54fgzztlejs.cloudfront.net/app/layout/images/no_avatar.png",
      "large": "https://d3l54fgzztlejs.cloudfront.net/app/layout/images/no_avatar.png"
    },
    "city": "Dallas",
    "state": "Texas",
    "notes": "Has CCNP certificate",
    "p_email": "1",
    "p_phone": "1",
    "notify_sms": "-1",
    "notify_email": "1",
    "e_new_pm": "0",
    "ical": "https://www.humanity.com/ical/151addef5d61ac3a09aa1b0e78c0bb47.ics",
    "24hr": "0",
    "startday": "1",
    "pref_caltime": "10",
    "pref_shift_autoconfirm": "-1",
    "undertime": "0",
    "overtime": "-1",
    "recommend": "0",
    "tut_v2_sched": "0",
    "daily_overtime": "0",
    "max_days_row": "-1",
    "monthly_undertime": "0",
    "monthly_overtime": "-1",
    "pref_mtimebshifts": "0",
    "deactivated": "0",
    "work_start_date": "2018-04-13 18:18:03",
    "screen_logger": "0",
    "sc_freq": "-2",
    "newsletter_receiver": "0",
    "gender": "M",
    "pref_sp_skin": "1",
    "teamtools_id": "0",
    "updated_at": "2018-04-13 18:18:03",
    "employee_type": "0",
    "pay_type": "0",
    "group": "5",
    "timezone_name": "Europe/Belgrade",
    "group_name": "Employee",
    "status_name": "Activated",
    "custom": {
      "26768": {
        "id": "26768",
        "name": "PTO balance [hours]",
        "type": "1",
        "access": "1"
      },
      "27043": {
        "id": "27043",
        "name": "CF2",
        "type": "1",
        "access": "1",
        "value": "Value for the custom field with ID 27043",
        "toggle": "0"
      },
      "27044": {
        "id": "27044",
        "name": "Checkbox CF",
        "type": "4",
        "access": "1"
      }
    },
    "settings": {
      "widgets_layout": [
        [
          "timeclock"
        ]
      ],
      "schedule_side_panel_visibility": 1,
      "linked_shift_time": 1,
      "schedule_view_selected": "week",
      "schedule_timeline_selected": "employee"
    }
  },
  "token": "xxxxxxxxxxxxxxxxxxxxxxxxx"
}

Changes