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.
  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.
Did this help?