Staff Members API Errors

This article outlines error messages that might be issued when calling endpoints of the Staff Members API.

Create Staff Member Errors

The Create Staff Member endpoint might issue the following error messages:

HTTP status	Error code	Error message	Troubleshooting
INVALID_ARGUMENT (400)	NO_IMAGE_FOUND	Image: imageId does not exist	The Wix Media API can't resolve the provided image ID. Upload the image first, then pass the ID it returns.

Update Staff Member Errors

The Update Staff Member endpoint might issue the following error messages:

HTTP status	Error code	Error message	Troubleshooting
INVALID_ARGUMENT (400)	NO_IMAGE_FOUND	Image: imageId does not exist	The Wix Media API can't resolve the provided image ID. Upload the image first, then pass the ID it returns.

Delete Staff Member Errors

The Delete Staff Member endpoint might issue the following error messages:

HTTP status	Error code	Error message	Troubleshooting
INVALID_ARGUMENT (400)	LAST_STAFF_DELETION	Can not delete last staff	A site must keep at least 1 staff member. Create a replacement staff member before deleting this one. To stop a staff member appearing in booking flows without deleting them, call Set Service Provider with serviceProvider set to false.

Set Service Provider Errors

The Set Service Provider endpoint might issue the following error messages:

HTTP status	Error code	Error message	Troubleshooting
INTERNAL (500)	FAILED_TO_ASSIGN_STAFF_ROLE	Failed to assign staff role to user: userId	Promoting a staff member grants the Wix user connected to them the Staff role, and that role assignment failed. The staff member's serviceProvider value is left unchanged, so the call is safe to retry. If it keeps failing, check that the connected Wix user is still a contributor on the site.

Connect Staff Member to User Errors

The Connect Staff Member to User endpoint might issue the following error messages:

HTTP status	Error code	Error message	Troubleshooting
INVALID_ARGUMENT (400)	NO_EMAIL	Staff: staffId has no email and no additional email was provided	The staff member needs an email address to be connected to a Wix user. Either set the staff member's email, or specify an email address in the request.
INVALID_ARGUMENT (400)	STAFF_ALREADY_CONNECTED	Staff: staffId is already connected	The staff member is already connected to a Wix user. Call Disconnect Staff Member From User before connecting a different user.
UNAUTHENTICATED (400)	USER_ALREADY_CONNECTED	User userId already connected	The Wix user with the specified email address is already connected to a different staff member.
ALREADY_EXISTS (400)	INVITE_ALREADY_SENT	Staff invite for staff: staffId already sent	The email address in the request, or the one on the staff member, already has a pending invite. Wait for the invite to be accepted or to expire.

Disconnect Staff Member from User Errors

The Disconnect Staff Member From User endpoint might issue the following error messages:

HTTP status	Error code	Error message	Troubleshooting
INVALID_ARGUMENT (400)	STAFF_NOT_CONNECTED	Staff: staffId is not connected	The staff member doesn't have a Wix user connected to them.

Assign Working Hours Schedule Errors

The Assign Working Hours Schedule to Staff Member endpoint might issue the following error messages:

HTTP status	Error code	Error message	Troubleshooting
INVALID_ARGUMENT (400)	INVALID_WORKING_HOURS_SCHEDULE	Provided schedule id: scheduleId is invalid, it must either be the business schedule id or the staff's events schedule id	scheduleId accepts only 2 values. To give the staff member custom working hours, pass their own event schedule ID. To put them back on the business default hours, pass the business schedule ID. Retrieve the staff member's event schedule ID by calling Get Staff Member with RESOURCE_DETAILS in the fields parameter and reading resource.eventsSchedule.id.