Staff Members API: Sample Flows

This guide provides sample flows focusing on the technical details of managing staff members using the Staff Members API. These flows demonstrate common integration patterns and serve as a foundation for implementation.

Connect a staff member to a Wix user

To enable staff members to manage their own working hour schedule in their dashboard, connect a staff member to a Wix user.

To connect a staff member to a Wix user:

1. Call Query Staff Members. Save the relevant staff member ID.
2. Call Connect Staff Member to User. Specify the staff member ID. If an existing Wix user is related to the staff member but has a different email address than the staff member's email, specify that email address.
3. Call Get Staff Member, specifying ASSOCIATED_IDENTITY_STATUS in the fields parameter. Check the value of the associatedWixIdentity.connection.status field.

Assign a staff working hour schedule

To create custom working hours that differ from the business default schedule, assign a custom working hour schedule to a staff member.

To assign a working hour schedule to a staff member:

1. Call Query Staff Members, specifying RESOURCE_DETAILS in the fields parameter. Save the relevant staff member ID and their resource.eventsSchedule.id.
2. Call Assign Working Hours Schedule to Staff Member. Specify the values retrieved in the previous step as staffMemberId and scheduleId. Note: The method requires the event schedule ID from step 1, even though the method is called Assign Working Hours Schedule to Staff Member.
3. Optional: To modify working hours, use the Events V3 API. For details on modifying working hours, see business schedule management.