Enabling Integration with Clock PMS
An administrator or a subscription owner will need to perform these actions to enable the integration.
- In Clock PMS portal, navigate to Settings > All Settings
![Notion image](https://www.notion.so/image/https%3A%2F%2Fs3-us-west-2.amazonaws.com%2Fsecure.notion-static.com%2F1f85a71f-2ae4-481b-838d-8286fab81992%2FScreen_Shot_2022-08-12_at_2.41.54_PM.png?table=block&id=2c6c317d-1376-4191-9660-5fdac0c1f09d&cache=v2)
- Find the API Users page under Advanced Settings
- Select 'Add'. In the 'User Name' field, fill in the name of the company, product or developer that will use the API.
You may receive an error from Clock PMS stating “Create / Update are not allowed for an API User.”
Please contact integrations@clock-hs.com to let them know that are you looking to activate the integration with Akia. Clock PMS’s representative will create and share the relevant credentials on your behalf.
- Select the Accounts that the API can access. This will typically be your hotels.
![Notion image](https://www.notion.so/image/https%3A%2F%2Fs3-us-west-2.amazonaws.com%2Fsecure.notion-static.com%2F4aa29c1c-6b33-402b-a1dc-cecfe4f8b954%2FScreen_Shot_2022-08-12_at_2.49.38_PM.png?table=block&id=7b3b2962-7e1f-4fbd-a191-f9f13b31c685&cache=v2)
- Under ‘Grant Rights - PMS’, select Personal Data: Access and Personal Data: Bulk Access
![Notion image](https://www.notion.so/image/https%3A%2F%2Fs3-us-west-2.amazonaws.com%2Fsecure.notion-static.com%2F517624f6-c75a-44c9-a3a1-3e8b4b844a28%2FScreen_Shot_2022-08-12_at_2.51.15_PM.png?table=block&id=bb0948c7-54ab-4677-919e-3e07a1a85163&cache=v2)
- Select Folios under ‘Grant Rights - BaseApi’
![Notion image](https://www.notion.so/image/https%3A%2F%2Fs3-us-west-2.amazonaws.com%2Fsecure.notion-static.com%2F6366fe41-f3fe-4e1a-bc60-415873c937d6%2FScreen_Shot_2022-08-12_at_2.53.32_PM.png?table=block&id=fe733552-5ea3-41f8-8562-4d4f9a0d098f&cache=v2)
- Select BookingFolios, Bookings, RoomTypes, and Rooms under ‘Grant Rights - PmsApi’
![Notion image](https://www.notion.so/image/https%3A%2F%2Fs3-us-west-2.amazonaws.com%2Fsecure.notion-static.com%2F102f2f41-c059-44cf-bead-050efc55e933%2FScreen_Shot_2022-08-12_at_2.55.07_PM.png?table=block&id=56db55de-a384-4329-9cc3-153a5fc0695e&cache=v2)
- Click Save.
- Open the newly created API User by clicking on ‘Edit’
- Click the ‘Create API Key’ button.
- Give your Akia representative the ‘User Name’, ‘API Key’, and the URLs from the ‘Api Endpoints’ section.
- Save.
Enabling Real-Time Events
- Contact integrations@clock-hs.com and let them know that you want to enable PUSH Notification to Akia.
- Grant the following Events:
- housekeeping_changed
- booking_new
- booking_update
- booking_expected
- booking_checked_in
- booking_checked_out
- booking_canceled
- booking_no_show
- Provide the Akia Endpoint URL for the events to Clock PMS
The Endpoint URL will be https://sys.akia.ai/webhooks/clock/<third_party_token>. Please confirm with your Akia representative on your final URL as the Third Party Token is uniquely generated for your Akia account.
Integration Breakdown
- 1-way integration - Akia only receives reservations from Clock, we cannot send data back
- Webhooks - Akia receives bookings right when they happen or when a booking is updated (dictated by the events above)
What Can I Do Now That I Have Clock PMS?
- Send a message right when the Booking is Confirmed or x days before a guest arrives
- Send a message when the room is marked as ready, the guest has checked in, or upon checkout