This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Connects staff member to a Wix user.
By default the staff member's email is used to connect to the user. If the email is already associated with a Wix user with roles and permissions to access the site, the staff member is connected to that user. If the email is not associated with a Wix user, or the Wix user is not associated with the site, an invitation is sent to the email to join the site.
Connecting a staff member to a user gives access to the user to manage the staff's schedule via the Wix backoffice.
The status of a staff member's connection is stored in the associatedWixIdentity
field, and can be fetched using the requested field ASSOCIATED_IDENTITY_STATUS
.
The status of a connection can be one of the following:
CONNECTED
- The staff member is connected to a Wix user.PENDING
- An invitation was sent to the user to connect to the staff member.EXPIRED
- The invitation to connect to the staff member has expired.DISCONNECTED
- The staff member is not connected to a user.You can only call this method when authenticated as a Wix app or Wix user identity.
ID of the staff member. The staff member to connect to a user.
Email of the user to send invitation to. The staff existing email would be used if not provided.
Conditional fields to return.
The updated staff member. After connecting to the user.
Connect a staff member to a user, providing a custom email address.
curl -X POST \
'https://www.wixapis.com/bookings/v1/staff-members/0954bbb2-88cd-445c-9827-44253eb8b039/connect-staff-member-to-user' \
-H 'Authorization: <AUTH>' \
-d '{
"staffMemberId": "0954bbb2-88cd-445c-9827-44253eb8b039",
"email": "some-other@email.com"
}'
{
"staffMember": {
"id": "0954bbb2-88cd-445c-9827-44253eb8b039",
"email": "some@email.com",
"name": "Some other name",
"resourceId": "136d9d9a-97ab-49fa-a0cf-ec24f500bd98",
"default": false,
"revision": "3",
"createdDate": "2024-08-28T13:22:32.784Z",
"updatedDate": "2024-08-28T14:16:11.948Z"
}
}
This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.