Goki
Goki provides a cloud-based smart access platform for the hospitality industry. The Goki Portal manages smart locks and doorcodes (PIN codes) across properties. By integrating with HolidayHero, reservations and guest data are automatically synced to Goki, which generates unique doorcodes for each guest. These codes are delivered via the HolidayHero Guest App — both as an in-app display when tapping the lock, and optionally as a proactive message. Learn more at goki.travel.
Categories
Smart Devices
What does this integration do?
The Goki integration automates guest access for your smart locks. Once set up, you don't need to manually create or share door codes — everything happens automatically.
Automatic doorcode creation — When a reservation is confirmed, a unique PIN code is generated for each guest. No manual work required.
Doorcode in the Guest App — Guests tap the lock icon in the app to see their code with clear instructions.
Proactive messaging (optional) — The doorcode can be sent as a message to the guest via the Guest App as soon as it's ready.
Multi-language support — Doorcode messages can be written in your primary language. Missing translations are generated automatically using AI.
Doorcode visible to staff — The doorcode is written to a reservation metafield, so your team can see it in the HolidayHero admin.
Check-in gating (optional) — You can choose to withhold doorcodes until the guest has checked in. Before check-in, guests see a customizable message (e.g., "Please visit the reception to check in first.").
Automatic revocation — When a reservation is cancelled or a guest is removed, the doorcode is automatically revoked. No cleanup needed.
Multi-guest support — Every guest on a reservation gets their own doorcode.
Security: All communication between HolidayHero and Goki is server-to-server and encrypted. Webhook payloads are verified using cryptographic signatures to prevent tampering.
Guides
How to set up the Goki integration?
Step 1 — In the Goki Portal
Log in to the Goki Portal Dashboard
Navigate to your property's Marketplace Apps
Install the HolidayHero app
Note down the Connection Base URL, Connection Secret, and Connection ID
Step 2 — In HolidayHero
Go to Integrations and select the Goki App
Click the Settings tab
Enter the credentials from Step 1
Choose your Keychain Creation Mode (see below)
Optionally enable doorcode messaging and set up your message template
Click Save
Go to the Home tab and activate the integration
How to connect your Goki locks?
Make sure the Goki integration is set up and the credentials are saved.
In the Goki integration, click the Smart Devices tab
Your Goki doors appear automatically
Click Connect next to each door you want to use
Then, attach the lock to a listing:
In HolidayHero Admin, go to Smart Devices
Select the connected lock and click View
Go to the Listings tab
Select which listings this lock belongs to
Click Save
The listing is automatically synced as a Space in the Goki Portal. Your staff can then map Spaces to physical Doors in the Goki dashboard.
How do guests receive their doorcode?
There are two ways:
1. In the Guest App
Guests see the lock in the Smart Devices section of the app
Tapping the lock shows their PIN code with the instruction "Enter the code below on the door lock"
The code is valid for the duration of their stay
2. Via a message (optional)
If enabled, the doorcode is sent automatically to the guest as a Guest App message
You can customize the message template with placeholders like the guest's name, listing name, and doorcode
Messages are sent in the guest's language when a translation is available
When is the doorcode created?
This depends on the Keychain Creation Mode in your settings:
Always (default)
As soon as the reservation is confirmed
When guest is checked in
Only after the guest has been checked in
With the "checked in" mode, guests who tap the lock before check-in see a message you can customize, for example: "Please visit the reception to check in before accessing your room."
Is there a delay before the doorcode is available?
Yes, there can be a short delay (usually under a minute). When a reservation is synced, Goki needs to provision the code to the physical lock hardware. Once ready, the code appears in the Guest App and is optionally sent as a message.
Can I see the doorcode in the HolidayHero admin?
Yes. Go to the Metafields tab in the Goki integration and select a metafield to store the doorcode. Once configured, the doorcode appears on the reservation in the admin — visible to your staff.
If a guest has codes for multiple doors, they are shown as a comma-separated list.
What happens when a reservation is cancelled?
The cancellation is synced to Goki automatically. All doorcodes for that reservation are revoked immediately. The guest will no longer see a code in the Guest App.
What happens when a guest is added or removed?
Guest added — A new doorcode is created automatically for the new guest
Guest removed — Their doorcode is revoked. Other guests' codes are not affected
What happens when dates change?
The updated dates are synced to Goki. The doorcode stays the same — only the time window it's valid for is adjusted.
Can I manage doorcodes in the Goki Portal?
Yes. Staff can view, revoke, or modify keychains in the Goki Portal dashboard.
If a keychain is manually revoked in the Goki Portal, HolidayHero is updated automatically. However, keychains created manually in the Goki Portal will not appear in HolidayHero.
How do multi-language messages work?
Write your doorcode message in your primary language using placeholders:
{{ firstname }}— Guest's first name{{ lastname }}— Guest's last name{{ listing.name }}— Listing name{{ doorCode }}— The PIN code
Leave other languages empty — they are translated automatically using AI
Or write custom translations for specific languages
The message is sent in the guest's language. If no translation exists, the primary language is used.
Events
This integration listens to the following events from HolidayHero:
Reservation created
The reservation and guest details are synced to Goki. A doorcode is generated for each
guest.
Reservation updated
Changes to dates, guests, or status are synced to Goki. Doorcodes are updated or created
as needed.
Reservation cancelled
The cancellation is synced. All doorcodes for the reservation are revoked.
Listing deleted
The linked smart device mapping is removed from the integration.
Last updated