Before You Begin
To complete this setup you need an active Reservit account with administrator access. Standard staff user accounts do not have permission to access API settings in Reservit. If you do not have administrator access, contact your Reservit account owner before proceeding. You will also need your ItReserve module access — if you have not yet purchased a module, visit the module catalogue to choose one. Once payment is confirmed you will receive an access email containing your ItReserve dashboard URL.
Step 1 — Find Your Reservit Account Settings
Log into your Reservit account at the Reservit login URL provided when your account was created. Once logged in, navigate to the Settings area. In most Reservit versions, Settings is accessible from the main navigation menu, usually in the upper-right area of the screen or within a dropdown menu under your account name. The exact location varies slightly between Reservit versions — if you cannot locate it, check the Reservit help documentation or contact Reservit support for your specific version.
Within Settings, look for a section labelled Integrations, Developer, or API. This section contains all configuration options related to third-party connections. If you see multiple subsections, look for one that references API keys, API access, or External connections.
Step 2 — Enable API Access
Some Reservit accounts have API access disabled by default. Within the API or Integrations section of your Settings, check whether there is an Enable API access toggle or checkbox. If API access is shown as disabled, enable it now. You may be required to confirm this change with your Reservit account password. After enabling API access, the API key generation interface should become visible within the same settings section.
If you do not see any option to enable API access and the API key section is not present, your Reservit plan may not include API access. In that case, contact Reservit's sales or support team to confirm whether your plan includes API connectivity and whether an upgrade is required.
Step 3 — Generate an API Key
Within the API settings section, locate the option to create or generate a new API key. Click the relevant button — typically labelled Generate API key, Create new key, or Add API key. Reservit will prompt you to name the key. Use a descriptive name that identifies the purpose of this key, such as ItReserve Module Connection. A clear name makes it easier to manage your API keys if you have multiple integrations connected in the future.
Once generated, the API key will be displayed on screen. This is the only time Reservit will show you the full key value — copy it immediately and store it securely. A password manager is suitable for this purpose. Do not share your API key publicly or include it in any emails or documents that may be forwarded. Treat it with the same care as a password.
Step 4 — Set API Permissions
Reservit allows you to assign specific permissions to each API key, controlling what data the connected application can read or modify. The permissions you need depend on which ItReserve module you are connecting. The table below lists the required permissions per module category.
| Module Category | Required Permissions | Notes |
|---|---|---|
| Analytics Board, Reporting | Reservations (read), Rooms (read), Rates (read) | Read-only access. No write permissions needed. |
| Yield Manager | Reservations (read), Rooms (read), Rates (read + write) | Write access needed to push rate updates to Reservit. |
| Channel Bridge | Reservations (read + write), Rooms (read + write), Rates (read + write) | Full access needed for two-way channel synchronisation. |
| Invoice Module | Reservations (read), Guest data (read), Folios (read) | Read-only. Invoices are generated by ItReserve, not written back to Reservit. |
| Guest Comms | Reservations (read), Guest data (read) | Read-only. Messages are sent from ItReserve, not through Reservit. |
| Housekeeping Pro | Rooms (read + write), Housekeeping status (read + write) | Write access needed to update room status in Reservit. |
| Corporate Contracts | Reservations (read), Rates (read), Guest profiles (read) | Read-only. Contract rates are managed within ItReserve dashboard. |
Grant only the permissions your specific module requires. Principle of least privilege — giving an integration only the access it actually needs — reduces the potential impact of a key being compromised.
Step 5 — Test the Connection
Before entering your API key into the ItReserve dashboard, verify that the key is valid by making a test request. The simplest test is to use the Reservit API documentation's built-in request tester, if available, or to use a tool such as Postman or curl. Enter your API key in the Authentication header and make a request to the reservations endpoint. A successful response confirming your property's reservation data indicates that the key is working correctly.
If the test returns an authentication error, confirm that the API key was copied correctly with no leading or trailing spaces, and that API access is enabled on your Reservit account. If the test returns a permissions error, review the permissions assigned to your key and ensure that the endpoint you are testing requires only the permissions you have granted.
Step 6 — Enter the API Key in Your ItReserve Dashboard
Open your ItReserve module dashboard using the access link from your onboarding email. Navigate to Settings and then to Reservit Connection. In the API Key field, paste the key you copied from Reservit. Enter your Reservit property ID in the Property ID field — this is typically a numeric identifier found in your Reservit account settings or in the URL when you are logged into Reservit. Click Save and Connect.
The ItReserve dashboard will attempt to verify the connection immediately. A green connected status indicator confirms that your module has successfully authenticated with your Reservit account. The module will begin reading data from Reservit according to its configured sync interval — typically every 15 minutes for reservation and rate data.
Troubleshooting Common Issues
Connection fails with authentication error
The most common cause is an API key copied with extra whitespace. Clear the API Key field in the ItReserve dashboard and paste the key again carefully. Also confirm that the key has not been revoked or regenerated in Reservit since you created it.
Connection succeeds but no data appears
Check the permissions assigned to your API key in Reservit. If the key has read access to reservations but the module requires access to rates or rooms, data from those endpoints will not be available. Update the key's permissions in Reservit settings and retry the connection.
Connection fails with property ID error
Confirm your Reservit property ID in your Reservit account settings. If your account manages multiple properties, ensure you are using the property ID for the specific property you want to connect — not the account-level identifier.
API access option not visible in Reservit settings
Your Reservit plan may not include API access, or your user account may not have the administrator role required to view this section. Contact Reservit support to confirm your plan's API access status and request that your account role be updated if necessary.