Staff

The Staff API is used to access, create, and modify any staff on your business' account. The Staff API is connected to the Locations API, in that staff members can be filtered based on which location is chosen for an appointment. Since staff members are necessary for creating appointments, as well as setting up class schedules and location availability, it is crucial for you to familiarize yourself with how to get, create, and update the staff on your account.

Staff are made accessible to all users on a business's account, but a user will only be able to access his or her own staff's information and book appointments for him- or herself unless he or she is an admin or a location super user.

On this page

1 Staff API Endpoints
2 Staff API Parameters
3 Staff API Request Body/Payloads
4 Staff API Responses
5 Staff Object Values

Staff API Endpoints

Return to Top

These are the endpoints that are available under the /staff path, which lists all the different staff members you have added to your business using TimeTap.

Endpoint	Description

Endpoint	Description
GET /staff	Returns all staff objects on an account in array format.
GET /staff/{professionalId}	Returns a JSON object for the specified staff person.
GET /staff/{professionalId}/serviceStaff	Returns the objects of all services and classes on the account in array format.
GET /staffList/reportWithCount	Returns an object that contains a list of staff along with a count of the total number of staff that match the parameters passed with the call.
GET /staffList/report	Returns an object that contains a list of staff that match the parameters passed with the call.
GET /staffList/reportCount	Returns a count object that provides the number of staff that match the parameters passed with the call.
GET /staffIdList	Returns an object that contains list of the professional IDs for the locations that match the parameters passed with the call.
POST /staff	Creates a new staff object on an account. Request body/payload: Must pass a staff object in the request body/payload. For these calls, you need to pass a staff object with all required fields and any fields you want to set filled in the body of the payload. We have an example of a staff object in the responses section below and have indicated the required fields in the object values table at the bottom of this page.
POST /staff/{professionalId}	Updates an existing staff object on an account. Request body/payload: Must pass a staff object in the request body/payload. For these calls, you need to pass a staff object with all required fields and any fields you want to update filled in the body of the payload. We have an example of a staff object in the responses section below and have indicated the required fields in the object values table at the bottom of this page.
POST /staff/{professionalId}/serviceStaff	Updates the list of services/class that a staff member can offer. Be sure to set the active property on each service/class object in the array to true or false depending on whether the staff member offers that service/class. Request body/payload: Must pass the array of services/classes you got from the respective GET call in the request body/payload.
DELETE /staff/{{professionalId}}	Removes a staff object by setting its active property to false. Requires a JSON POST body with values signifying if they should cancel any open appointments that staff member has and if it should send those affected clients an email explaining why the appointments were cancelled, along with a string value of the personalized message to send in those emails. See example below. `{ "cancelOpenAppts": true, "sendClientEmail": true, "cancelReason": "{Reason for cancelling staff member's appointments}" }`

Staff API Parameters

Return to Top

Data points passed on in the request URL portion of the API call that are used to filter the data being requested.

Parameter	Type	Endpoints to be used with	Description

Parameter	Type	Endpoints to be used with	Description
acceptAppointments	boolean	GET /staff, GET /staffList/reportWithCount, GET /staffList/report, GET /staffList/reportCount, GET /staffIdList	If set to true, only staff members who have the acceptAppointments property on their staff object set to true will return.
dateRangeType	string	GET /staffList/reportWithCount, GET /staffList/report, GET /staffList/reportCount, GET /staffIdList	Can be set to a value of 'createdDate' or 'modifiedDate' and works with startDate and endDate parameters to filter staff returned following the API call based on those properties.
endDate	string	GET /staffList/reportWithCount, GET /staffList/report, GET /staffList/reportCount, GET /staffIdList	Should be set as a string formatted YYYY-MM-DD and works with the dateRangeType parameter to filter staff returned following the API call.
locationId	integer	GET /staff	Should be set as a comma-separated list of all staff that have working hours at specified location.
locationIdList	integer array	GET /staffList/reportWithCount, GET /staffList/report, GET /staffList/reportCount, GET /staffIdList	Should be set as a comma-separated list of locationIds and will only return staff who have access to the corresponding locations.
locationGroupIdList	integer array	GET /staff	Can be used when calling staff members from multiple locationIds that can be passed as a comma-separated list.
onlyAccessAllLocations	boolean	GET /staffList/reportWithCount, GET /staffList/report, GET /staffList/reportCount, GET /staffIdList	If set to true, it will only return staff whose security roles give access to all locations.
order_field	string	GET /staffList/reportWithCount, GET /staffList/report	Displays the field name used to order the data that gets returned following a GET call. The default used if nothing gets passed here is to sort based on the professionalId property.
order_mode	string	GET /staffList/reportWithCount, GET /staffList/report	Displays the order type that is used to order the data that gets returned following a GET call. Available options are "asc" for ascending and "desc" for descending.
reasonIdList	integer array	POST /staff, GET /staffList/reportWithCount, GET /staffList/report, GET /staffList/reportCount, GET /staffIdList	Automatically assigns the staff being created to the reasonIds being passed. The reasonIdList should be passed as a comma separated list.
searchTerm	string	GET /staffList/reportWithCount, GET /staffList/report, GET /staffList/reportCount, GET /staffIdList	Searches the following staff object properties to see if there is any substring match - description, userName, cellPhone, fullName, emailFooter, internalName, emailInstructions, emailInstructions2.
securityRoleIdList	integer array	GET /staffList/reportWithCount, GET /staffList/report, GET /staffList/reportCount, GET /staffIdList	Should be set as a comma-separated list of security role IDs and will only return staff who are assigned to those security roles.
staffIdList	integer array	GET /staffList/reportWithCount, GET /staffList/report, GET /staffList/reportCount, GET /staffIdList	Should be set as a comma-separated list of staff IDs and will only return those staff that match those IDs.
staffIdListToExclude	integer array	GET /staffList/reportWithCount, GET /staffList/report, GET /staffList/reportCount, GET /staffIdList	Should be set as a comma-separated list of staff IDs and will only return those staff that do not match those IDs.
startDate	string	GET /staffList/reportWithCount, GET /staffList/report, GET /staffList/reportCount, GET /staffIdList	Should be set as a string formatted YYYY-MM-DD and works with the dateRangeType parameter to filter staff returned following the API call.
statusList	string	GET /staffList/reportWithCount, GET /staffList/report, GET /staffList/reportCount, GET /staffIdList	Should be set as a comma-separated list of available staff statuses (right now there is only support for 3 staff statuses: ACTIVE, DEACTIVE, DELETED). The default used if no value is passed here is ACTIVE.
userNameList	string	GET /staffList/reportWithCount, GET /staffList/report, GET /staffList/reportCount, GET /staffIdList	Should be set as a comma-separated list of usernames and will only return staff whose usernames match the values passed.
working	boolean	GET /staffList/reportWithCount, GET /staffList/report, GET /staffList/reportCount, GET /staffIdList	If set to true, will only return staff who have working hours set up - works in conjunction with the locationIdList and reasonIdList parameters if those are filled in to only return staff that are working at those locationIds and offer those reasonIds.

Staff API Request Body/Payloads

Return to Top

The objects below represent the minimum viable objects to pass that are needed to create or update a staff object. Check whether or not a property can be written to by looking at the Object Values table below to see if the property is writable.

{
    "acceptAppointments": true,
    "email": "noreply@timetap.com",
    "emailFooter": "(HTML text for email footer)",
    "fullName": "Earl E",
    "locationAccessList": null,
    "locationIdAccessList": null,
    "locationList": [],
    "newApptSms": false,
    "securityRoleId": "5",
    "sendWelcomeMessage": false,
    "timeZone": {Timezone object for timezone of staff - for more info, see Timezones API page},
    "userName": "earltest"
}

{
    "acceptAppointments": true,
    "accountLocked": false,
    "active": true,
    "addnlVirtualRoomUrls": null,
    "allowOnline": true,
    "businessId": 43111,
    "changePasswordNextLogin": false,
    "clockedIn": null,
    "createdDate": 1696262180107,
    "createdUser": "JoeSchmo",
    "currentStationName": null,
    "dragging_row": false,
    "email": "noreply@timetap.com",
    "emailFooter": "(HTML text for email footer)",
    "emailInstructions": null,
    "emailInstructions2": null,
    "embedCode": null,
    "excludeEmailCategoryIdList": null,
    "firstDayOfWeek": null,
    "fullName": "Steve Test",
    "googleSyncActive": false,
    "googleSyncPeriod": "",
    "guestHashEnabled": false,
    "imageUrl": null,
    "internalDisplayName": "Steve Test",
    "internalName": null,
    "lastLoginDate": null,
    "locale": null,
    "locationGroupIdList": null,
    "locationIdAccessList": [
        "0": 81181
    ],
    "locationsWithSchedule": null,
    "mobilePhone": null,
    "newApptSms": false,
    "phone": null,
    "privateUrl": null,
    "professionalId": 484822,
    "readyToDrag": false,
    "reasonGroupIdList": null,
    "reasonIdList": null,
    "salesforceParm1": null,
    "salesforceUserId": null,
    "securityRole": null,
    "securityRoleId": 3,
    "securityRoleName": "User",
    "securityRoles": null,
    "skypeId": null,
    "sortWeight": 4,
    "staffProfile": null,
    "staffRateLevel": null,
    "status": "ACTIVE",
    "syncStaffIdList": null,
    "syncStaffList": null,
    "syncStaffUserName": null,
    "timeZone": {Timezone object for timezone of staff - for more info, see Timezones API page},
    "userName": "STEVETEST",
}

Staff API Responses

Return to Top

[{
    "acceptAppointments": null,
    "accountLocked": false,
	"active": true,
    "addnlVirtualRoomUrls": null,
    "allowOnline": true,
    "businessId": null,
    "changePasswordNextLogin": false,
    "clockedIn": null,
    "createdDate": 1525113573000,
    "createdUser": "JoeSchmo",
    "currentStationName": null,
    "email": noreply@email.com",
    "emailFooter": "<strong>You can contact us at:</strong><br/>%STAFF_FULLNAME%<br/>%BUSINESS_NAME%<br/>%STAFF_EMAIL%<br/>%STAFF_MOBILE%",
    "emailInstructions": null,
    "emailInstructions2": null,
    "embedCode": null,
    "excludeEmailCategoryIdList": null,
    "firstDayOfWeek": 0,
    "fullName": "Mr. Biscuits",
    "googleSyncActive": false,
    "googleSyncPeriod": "",
    "guestHashEnabled": "",
    "imageUrl": null,
    "internalDisplayName": "Mr. Biscuits",
    "internalName": null,
    "lastLoginDate": 1687447497625,
    "locale": null,
    "locationGroupIdList": [
        "0": 31289,
        "1": 31158,
        "2": 64091
    ],
    "locationIdAccessList": [
        "0": 81181,
        "1": 87877,
        "2": 282639,
        "3": 319495,
        "4": 495584,
        "5": 515417
    ],
    "locationsWithSchedule": null,
    "mobilePhone": null,
    "newApptSms": false,
    "phone": null,
    "privateUrl": null,
	"professionalId": 80891,
    "reasonGroupList": [
        "0": 75773
    ],
    "reasonIdList": null,
    "salesforceParm1": null,
    "salesforceUserId": null,
    "securityRole": null,
    "securityRoleId": 4,
    "securityRoles": null,
    "skypeId": null,
    "sortWeight": 0,
    "staffProfile": null,
    "staffRateLevel": "premium",
    "status": "ACTIVE",
    "syncStaffIdList": null,
    "syncStaffList": null,
    "syncStaffUserName": null,
    "timeZone": {Timezone object for timezone of staff-see timezones API page},
	"userName": "TRUBISKY13"
    "virtualRoomId": null,
    "virtualRoomUrl": null
}]

{
    "acceptAppointments": true,
    "accountLocked": false,
	"active": true,
    "addnlVirtualRoomUrls": null,
    "allowOnline": true,
    "businessId": 21345,
    "changePasswordNextLogin": false,
    "clockedIn": null,
    "createdDate": 1522268786000,
    "createdUser": null,
    "currentStationName": null,
    "email": "noreply@email.com",
    "emailFooter": "<strong>You can contact us at:</strong><br/>%STAFF_FULLNAME%<br/>%BUSINESS_NAME%<br/>%STAFF_EMAIL%<br/>%STAFF_MOBILE%",
    "emailInstructions": null,
    "emailInstructions2": null,
    "embedCode": "<iframe src='http://www.timetap.com/pembed/q0ZQf1LYuB' frameborder='0' width='840' height='500'> </iframe>,
    "excludeEmailCategoryIdList": null,
    "firstDayOfWeek": null,
    "fullName": "Dr. J",
    "googleSyncActive": false,
    "googleSyncPeriod": "",
    "guestHashEnabled": false,
    "imageUrl": null,
    "internalDisplayName": "Dr. J",
    "internalName": null,
    "lastLoginDate": 1695752539452,
    "locale": "en-US",
    "locationGroupIdList": null
    "locationIdAccessList": [
        "0": 319495,
        "1": 157670,
        "2": 87877,
        "3": 282639
    ],
    "locationsWithSchedule": null,
    "mobilePhone": null,
    "newApptSms": false,
    "phone": null,
    "privateUrl": "http://www.timetap.com/appts/q0ZQf1lYu0",
	"professionalId": 81988,
    "salesforceParm1": null,
    "salesforceUserId": null,
    "securityRole": {
        "active": true,
        "businessId": null,
        "createdDate": 1167609600000,
        "createdUser": "Default",
        "modifiedDate": null,
        "modifiedUser": null,
        "securityRole": "Account Owner",
        "securityRoleCode": "OWNER",
        "securityRoleId": 1,
        "selectable": false
    },
    "securityRoleId": 3,
    "securityRoles": null,
    "skypeId": null,
    "sortWeight": 0
    "staffProfile": null,
    "staffRateLevel": "premium",
    "syncStaffIdList": null,
    "syncStaffList": null,
    "syncStaffUserName": null,
    "timeZone": {Timezone object for timezone of staff-see timezones API page},
	"userName": "DR.J54",
    "virtualRoomId": null,
    "virtualRoomUrl": null
}

[{
	"active": true,
    "businessId": 21345,
    "createdDate": 1522268786000,
    "createdUser": "Jane_Doe"
    "description": "Class Name"
    "modifiedDate": 1522268786021,
    "modifiedUser": "Jane_Doe"
    "price": null
	"professionalId": 77777,
    "professionalServiceId": 2005000
    "reasonId": 153346
    "reasonType": "CLASS"
}]

{
    "staff": [
    {
        "acceptAppointments": null,
        "accountLocked": false,
    	"active": true,
        "addnlVirtualRoomUrls": null,
        "allowOnline": true,
        "businessId": null,
        "changePasswordNextLogin": false,
        "clockedIn": null,
        "createdDate": 1525113573000,
        "createdUser": "JoeSchmo",
        "currentStationName": null,
        "email": noreply@email.com",
        "emailFooter": "(HTML text of email footer)",
        "emailInstructions": null,
        "emailInstructions2": null,
        "embedCode": "<iframe src='https://www.timetap.com/pembed/g0KDfMJXnFm' frameborder='0' width='840' height='500'> </iframe>",
        "excludeEmailCategoryIdList": null,
        "firstDayOfWeek": 0,
        "fullName": "Mr. Biscuits",
        "googleSyncActive": false,
        "googleSyncPeriod": "",
        "guestHashEnabled": false,
        "imageUrl": null,
        "internalDisplayName": "Mr. Biscuits",
        "internalName": null,
        "lastLoginDate": null,
        "locale": null,
        "locationGroupIdList": null,
        "locationIdAccessList": null,
        "locationsWithSchedule": null,
        "mobilePhone": null,
        "newApptSms": false,
        "phone": null,
        "privateUrl": "https://www.timetap.com/appts/g0KDfMJXnFm",
    	"professionalId": 80891,
        "reasonGroupIdList": null,
        "reasonIdList": null,
        "salesforceParm1": null,
        "salesforceUserId": null,
        "securityRole": {
        "active": true,
        "businessId": null,
        "createdDate": 1167609600000,
        "createdUser": "Default",
        "modifiedDate": null,
        "modifiedUser": null,
        "securityRole": "Account Owner",
        "securityRoleCode": "OWNER",
        "securityRoleId": 1,
        "selectable": false
    },
        "securityRoleId": 1,
        "securityRoles": null,
        "skypeId": null,
        "sortWeight": 0,
        "staffProfile": null,
        "staffRateLevel": null,
        "status": "ACTIVE",
        "syncStaffIdList": null,
        "syncStaffList": null,
        "syncStaffUserName": null,
        "timeZone": {Timezone object for timezone of staff-see timezones API page},
	    "userName": "TRUBISKY13",
        "virtualRoomId": "123",
        "virtualRoomUrl": "www.test.com"
}]

[{
    "acceptAppointments": true,
    "accountLocked": false,
	"active": true,
    "addnlVirtualRoomUrls": null,
    "allowOnline": true,
    "businessId": 21345,
    "changePasswordNextLogin": false,
    "createdDate": 1522268786000,
    "currentStationName": null,
    "email": "noreply@email.com",
    "emailFooter": "<strong>You can contact us at:</strong><br/>%STAFF_FULLNAME%<br/>%BUSINESS_NAME%<br/>%STAFF_EMAIL%<br/>%STAFF_MOBILE%",
    "embedCode": "<iframe src='http://www.timetap.com/pembed/q0ZQf1LYuB' frameborder='0' width='840' height='500'> </iframe>,
    "excludeEmailCategoryIdList": null,
    "firstDayOfWeek": null,
    "fullName": "Dr. J",
    "googleSyncActive": false,
    "guestHashEnabled": "",
    "imageUrl": null,
    "internalDisplayName": "Dr. J",
    "internalName": null,
    "lastLoginDate": null,
    "locale": null,
    "locationIdAccessList": [319495,  157670, 87877, 282639],
    "mobilePhone": null,
    "newApptSms": false,
    "privateUrl": "http://www.timetap.com/appts/q0ZQf1lYu0",
	"professionalId": 81988,
    "salesforceUserId": null,
    "securityRoleId": 3,
    "skypeId": null,
    "sortWeight": 0
    "staffProfile": null,
    "syncStaffIdList": null,
    "syncStaffUserName": null,
    "timeZone": {Timezone object for timezone of staff-see timezones API page},
	"userName": "DR.J54"
}]

{
    "count": 8
}

{
    "acceptAppointments": true,
    "accountLocked": false,
	"active": true,
    "addnlVirtualRoomUrls": null,
    "allowOnline": true,
    "businessId": 21345,
    "changePasswordNextLogin": false,
    "clockedIn": null,
    "createdDate": 1522268786000,
    "createdUser": "JoeSchmo",
    "currentStationName": null,
    "email": null,
    "emailFooter": (HTML text of email footer),
    "emailInstructions": null,
    "emailInstructions2": null,
    "embedCode": null,
    "excludeEmailCategoryIdList": null,
    "firstDayOfWeek": 0,
    "fullName": "Sleepy Juan"
    "googleSyncActive": false,
    "googleSyncPeriod": "",
    "guestHashEnabled": false,
    "imageUrl": null,
    "internalDisplayName": "Sleepy Juan",
    "internalName": null,
    "lastLoginDate": 156773877456,
    "locale": null,
    "locationGroupIdList": null,
    "locationIdAccessList": null,
    "locationsWithSchedule": null,
    "mobilePhone": "5551234",
    "newApptSns": false,
    "phone": null,
    "privateUrl": null,
	"professionalId": 21345,
    "reasonGroupIdList": null,
    "reasonIdList": null,
    "salesforceParm1": null,
    "salesforceUserId": null,
    "securityRole": null,
    "securityRoleId": 2,
    "securityRoles": null,
    "skypeId": null,
    "sortWeight": 0,
    "staffProfile": null,
    "staffRateLevel": null,
    "status": "ACTIVE",
    "syncStaffIdList": null,
    "syncStaffList": null,
    "syncStaffUserName": null,
    "timeZone": {Timezone object for timezone of staff-see timezones API page},
	"userName": "SLEEPY2",
    "virtualRoomId": null,
    "virtualRoomUrl": null
}

{
    "acceptAppointments": true,
    "accountLocked": false,
    "active": true,
    "addnlVirtualRoomUrls": null,
    "allowOnline": true,
    "businessId": 43111,
    "changePasswordNextLogin": false,
    "clockedIn": null,
    "createdDate": 1696262180107,
    "createdUser": "JoeSchmo",
    "currentStationName": null,
    "dragging_row": false,
    "email": "noreply@timetap.com",
    "emailFooter": "(HTML text for email footer)",
    "emailInstructions": null,
    "emailInstructions2": null,
    "embedCode": null,
    "excludeEmailCategoryIdList": null,
    "firstDayOfWeek": null,
    "fullName": "Steve Test",
    "googleSyncActive": false,
    "googleSyncPeriod": "",
    "guestHashEnabled": false,
    "imageUrl": null,
    "internalDisplayName": "Steve Test",
    "internalName": null,
    "lastLoginDate": null,
    "locale": null,
    "locationGroupIdList": null,
    "locationIdAccessList": [
        "0": 81181
    ],
    "locationsWithSchedule": null,
    "mobilePhone": null,
    "newApptSms": false,
    "phone": null,
    "privateUrl": null,
    "professionalId": 484822,
    "readyToDrag": false,
    "reasonGroupIdList": null,
    "reasonIdList": null,
    "salesforceParm1": null,
    "salesforceUserId": null,
    "securityRole": null,
    "securityRoleId": 3,
    "securityRoles": null,
    "skypeId": null,
    "sortWeight": 4,
    "staffProfile": null,
    "staffRateLevel": null,
    "status": "ACTIVE",
    "syncStaffIdList": null,
    "syncStaffList": null,
    "syncStaffUserName": null,
    "timeZone": {Timezone object for timezone of staff - for more info, see Timezones API page},
    "userName": "STEVETEST",
    "virtualRoomId": 
}

Staff Object Values

Return to Top

Property name	Type	Required	Writable	Description

Property name	Type	Required	Writable	Description
acceptAppointments	boolean		Yes	Indicates whether or not the specified staff person is accepting appointments.
accountLocked	boolean		Yes	Indicates whether or not the specified staff's account is locked.
active	boolean	Yes		Indicates whether or not the specified staff person should return on GET calls.
addnlVirtualRoomUrls	string		Yes	Provides a list of all additional virtual room URLs the specified staff has associated with themself.
allowOnline	boolean		Yes	Indicates whether or not the specified staff person is bookable on the scheduler or only on the back office.
businessId	integer	Yes		Provides a unique numerical ID of the business to which the staff person belongs.
changePasswordNextLogin	boolean		Yes	Indicates whether or not the Prompt to Change Password box is checked.
clockedIn	boolean		Yes	If your business uses the clock in screen, this value will indicate whether or not the specified staff person is currently clocked in and taking appointments from the queue of checked-in clients.
createdDate	integer			Displays as the date the specified staff person was added to your business account, in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
createdUser	string			Displays the username of user who created the specified staff's account.
currentStationName	string		Yes	Displays if the specified staff person is clocked in using the clockedIn property described above and have clocked in to a specific station.
email	string		Yes	Displays as the email address for the specified staff person.
emailFooter	string		Yes	This footer can be included in any emails sent on behalf of the specified staff person by including the tag "STAFF_SIGNATURE", and displays as a personalized signature for that staff person.
emailInstructions	string		Yes	Displays as what is saved as the specified staff's email instructions.
emailInstructions2	string		Yes	Displays as what is saved as the specified staff's additional email instructions.
embedCode	string			Provides iframe code that can be used to display scheduler for the specified staff person based on the address provided in staff description - back-end component, users cannot alter.
excludeEmailCategoryIdList	array		Yes	Displays a list of email category IDs the specified staff person elects not to receive.
firstDayOfWeek	integer		Yes	Acts as a 0-6 scale that determines what day begins the specified staff person's work week, where 0=Sunday, 1=Monday, etc.
fullName	string	Yes	Yes	Displays as the specified staff’s first and last name.
googleSyncActive	boolean		Yes	Indicates whether or not the specified staff person has an external calendar sync set up. This works for any external calendars, not just Google Calendars.
googleSyncPeriod	string			Displays as the period between Google syncs that the specified staff has.
guestHashEnabled	boolean		Yes	Indicates whether or not the specified staff person has had a guest landing page set up for them to enter their hours of availability.
imageUrl	string		Yes	Displays as the URL of the specified staff person's profile picture.
internalDisplayName	string		Yes	If fullName is filled out but internalName is empty, internalDisplayName would be the same as the fullName - if the internalName is not empty, the internalDisplayName would be the same as the internalName.
internalName	string		Yes	Displays as name that other staff members see for the specified staff person.
lastLoginDate	string			Displays as the date that specified staff person last logged in, in milliseconds elapsed since January 1, 1970 00:00:00 UTC form. .
locale	string		Yes	Displays as general preferred country and language of specified staff person; by default this value is read from their browser settings - for more info, see Locale API page.
locationGroupIdList	array		Yes	Displays as an array of the IDs of the location groups whose locations a staff person can access to add working hours and see appointments.
locationIdAccessList	array		Yes	Displays as an array of the IDs of the locations a staff person can access to add working hours and see appointments, and their security role ID will determine whether they only see their own appointments or if they are able to see other staff members' appointments at these locations. The "user" security role, which is securityRoleId=3, would be the only default security role that would not be able to see other staff members' appointments at the locations to which they have been given access.
locationsWithSchedule
mobilePhone	string		Yes	Displays as mobile phone number of the specified staff person where they will receive text message alerts if the newApptSms property on their account is set to true.
newApptSms	boolean		Yes	Indicates whether or not the specified staff person elects to receive text messages for new appointment bookings.
privateUrl	string