Bookings Staff Members APIs: Sample Flows

This article demonstrates common integration patterns for the Bookings Staff Members APIs.

Retrieve staff contact information

Retrieve staff members' email addresses and phone numbers based on the current privacy settings.

1. Call Get Staff Member Settings to check if contact information is publicly accessible. If staffMemberSettings.contactInformation.publiclyAccessible is false, the identity you're authenticated as needs the BOOKINGS.STAFF_MEMBER_READ_PI permission to retrieve contact information.
2. Call Get Staff Member or Query Staff Members with the staff member ID. Query Staff Members returns only staff members who provide services. To retrieve contact information for the entire staff, including staff members such as receptionists and managers, call Query Staff Members V2 instead.
3. Access the email and phone properties in the response to get the contact information. If publiclyAccessible is false and you don't have the BOOKINGS.STAFF_MEMBER_READ_PI permission, these properties are empty. The Staff Members API is the only way to retrieve this information. There's no alternative API method. For staff member gender, visibility is controlled by staffMemberSettings.staffProperties.genderPubliclyAccessible.