📘

NOTE

When saving a new set of locations, departments, or roles, you need to include all of those associations again, as anything not included in the payload is wiped out. For instance, if the user already belongs to department ID 123, but you want to add them to department ID 345, and both departments are under location ID 567, you have to send the request as follows:

{ "location": [{"id": 567}], "department": [{"id": 123}, {"id": 345}] }

Example response

{
  "status": "success",
  "data": {
    "location": [
      {
        "thu_hours_open": "07:00:00",
        "id": 123,
        "fri_closed": false,
        "country": "US",
        "thu_hours_close": "21:30:00",
        "state": "OR",
        "shift_feedback": false,
        "timezone_updated": true,
        "sat_closed": false,
        "tue_hours_close": "21:30:00",
        "mon_hours_close": "21:30:00",
        "address": "Store 06",
        "place_id": "",
        "sun_closed": false,
        "department_based_budget": false,
        "created": "2012-02-01 05:41:08",
        "modified": "2017-08-18 22:01:52",
        "company_id": 456,
        "uuid": "",
        "sat_hours_close": "21:30:00",
        "sun_hours_close": "21:30:00",
        "mon_hours_open": "07:00:00",
        "tue_closed": false,
        "sat_hours_open": "07:00:00",
        "mapping_id": "",
        "hash": "6cc641c218af1330b12c311d645715fa",
        "groups_user": {
          "sort": 0,
          "deleted": null,
          "id": 123,
          "group_id": 403,
          "created": "2021-08-13 02:24:31",
          "user_id": 3502369,
          "modified": "2021-08-13 02:25:55"
        },
        "formatted_address": "",
        "city": "Oregon City",
        "lng": "-122.60504220",
        "mon_closed": false,
        "holiday_pay": false,
        "wed_hours_close": "21:30:00",
        "fri_hours_open": "07:00:00",
        "wed_hours_open": "07:00:00",
        "deleted": null,
        "lat": 45.336446500000001,
        "thu_closed": false,
        "wed_closed": false,
        "sun_hours_open": "07:00:00",
        "tue_hours_open": "07:00:00",
        "fri_hours_close": "21:30:00",
        "auto_send_log_book_time": null,
        "timezone": "America/Los_Angeles",
        "message": "HAVE A GREAT WEEK      EVERYONE!!!"
      }
    ],
    "role": [
    ],
    "permission": {
      "timeoff_approve_decline": false,
      "shiftpool_approve_decline": false,
      "id": 3332,
      "compliance_exceptions_manage": false,
      "emp_e": false,
      "templates_manage": false,
      "timeoff_approve_decline_own": false,
      "roles_manage": false,
      "labor_manage": false,
      "timepunch_crud_self": false,
      "emp_c": false,
      "sales_manage": false,
      "company_id": 384,
      "hiring_view_page": false,
      "enterprise_overview": false,
      "restrict_billing": false,
      "sched_manage": false,
      "post_d": false,
      "hiring_manage_job_postings": false,
      "view_shift_feedback": false,
      "timepunch_crud": false,
      "hiring_manage_candidate_notes": false,
      "emp_labor_cost": false,
      "tip_pool_report": false,
      "picture_punch_view": false,
      "emp_d": false,
      "sched_d": false,
      "health_check_data_view": false,
      "user_id": 3502369,
      "reports": false,
      "can_manage_tasks_settings": false,
      "tasks_manage": false,
      "events_manage": false,
      "timeoff_manage": false,
      "tip_pool_manage": false,
      "availability_manage": false,
      "timepunch_period_edit": false
    },
    "department": [
      {
        "users_schedule_type": {
          "id": 1243,
          "deleted": null,
          "user_id": 123,
          "sort": 0,
          "appear_on_schedule": 1,
          "schedule_type_id": 413
        },
        "deleted": null,
        "id": 445,
        "company_id": 667,
        "uuid": "",
        "created": "0000-00-00 00:00:00",
        "location_id": 444,
        "modified": "2021-08-13 02:18:38",
        "name": "FOH",
        "default": 0
      },
      {
        "users_schedule_type": {
          "id": 123,
          "deleted": null,
          "user_id": 3502369,
          "sort": 0,
          "appear_on_schedule": 1,
          "schedule_type_id": 59969
        },
        "deleted": null,
        "id": 234,
        "company_id": 384,
        "uuid": "",
        "created": "2018-09-17 16:08:54",
        "location_id": 234,
        "modified": "2021-08-13 02:25:15",
        "name": "Back of house",
        "default": 0
      }
    ],
    "user": {
      "email_me_employee_health_check": false,
      "sms_me_schedules": true,
      "wage_type": "hourly",
      "id": 123,
      "hourly_wage": 0,
      "active": true,
      "company_id": 456,
      "photo": "https://app.7shifts.com/img/nophoto/1.png",
      "email_me_timeoff_requests": true,
      "user_type_id": 1,
      "email_me_shiftpool_requests": true,
      "email_me_global_messages": true,
      "invite_expiry": "-0001-12-05 00:00:00",
      "created": "2021-08-13 01:57:06",
      "notes": "",
      "notify_ot_actual": true,
      "address": "",
      "mobile_me_wall_posts": true,
      "postal_zip": "",
      "appear_as_employee": true,
      "sms_me_late_punch_in": true,
      "max_weekly_hours": "",
      "email_me_schedules": true,
      "home_phone": "",
      "sms_me_shiftpool": true,
      "mobile_me_logbook_posts": true,
      "employee_id": "",
      "birth_date": null,
      "email_me_availability_changes": true,
      "skill_level": 2,
      "email": "",
      "payroll_id": "",
      "push": false,
      "notify_break_alerts": true,
      "sms_me_global_messages": true,
      "email_me_punch_errors": true,
      "mapping_id": "",
      "firstname": "Billy",
      "notify_ot_risk": true,
      "email_me_shiftpool": true,
      "hire_date": "0000-00-00",
      "sms_me_shiftpool_requests": true,
      "email_me_logbook_posts": true,
      "email_me_digest_stats": true,
      "invited": "0000-00-00 00:00:00",
      "modified": "2021-08-13 01:57:06",
      "identity_id": null,
      "email_me_late_punch_in": true,
      "lastname": "Johnson",
      "city": "",
      "mobile_phone": "",
      "email_me_new_wall_posts": true,
      "invite_accepted": null,
      "prov_state": "",
      "sms_me_timeoff_requests": true,
      "last_login": "0000-00-00 00:00:00",
      "lang": "en",
      "subscribe_to_updates": false,
      "sms_me_employee_health_check": false
    }
  },
  "message": "User saved."
}
Language
Authentication
Basic
base64
:
Response
Click Try It! to start a request and see the response here!