1. Help Center
  2. OpenKey App and HOST Platform Training

Automated Key Delivery: Country Codes

Automated Key Delivery: Country Codes


Including country codes for international phone numbers within your PMS reservations is required.  The guest will not receive the mobile key if the country code is not present.  For US/Canada numbers, the +countrycode (+1) is not required.

When OpenKey HOST receives the guest’s information, the phone number must be validated before a mobile key can be issued.  Here is the process the platform goes through in order to validate the phone number:

  • HOST tries to validate the phone number as it is entered in the PMS, assuming the first 1-3 numbers is a country code
  • If that fails, HOST will prepend a “+1” and try again
  • If that fails, HOST will erase the “+1”, prepend a “+”, and try again
  • If that fails, HOST rejects the phone number and the guest is NOT added to OpenKey HOST

As a reminder, you must have both the + and a country code for international guests.  For US/Canada numbers, you must either include the entire country code (+1) or only the 10-digit number.  If you include the + without the country code, the mobile key will fail. 

SCENARIO: If a guest has a US phone number 662 XXX XXXX (Mississippi), and the number is entered +662XXXXXXX (without the 1), HOST will read that phone number as +66 XXXX XXXX, which is the country code and phone number format for Thailand.