API Authentication is used to build private integrations that allow you to access your personal Event Temple data securely.
For Single Organizations, only Admins have permission to access this area. For Organizations part of a Chain, only Chain Admin users have permission. Chain Admin permissions are specifically required for generating and managing API keys, ensuring secure access across multiple hotels or organizations.
Please refer to our Developers Hub for more information on this advanced tool.
Apps - OAuth 2.0 Authentication
Click on Settings
If you are part of a chain, click on the Organization Picker & select Chain
Scroll down the left-hand menu and click on Developers
Click Apps
Click + New App
Enter the Name of the App you'll be using this authentication for
Click Create
Optional: Add a redirect URL if required
Optional: Change the Scope if required Your authentication is now ready! Utilize the Oauth credentials as needed. If you are operating as a Chain Admin, ensure that you navigate to the Chain profile settings to access chain-level Developer options before proceeding.
Obtaining an API Org ID
Obtaining an API Org ID
Many APIs require you to pass an API Org ID header with your request.The Org ID specifies the organization the request is made against. You can use the organizations API request to get a list of organizations and their associated API Org ID within the chain.
You can also find it within Event Temple:
For a specific organization go to Settings > Overview for that organization
For all Organizations in a Chain go to Settings -> Chain -> Organizations from the Chain Dashboard.
Additional Information If using API Keys
API Keys are only accessible by admin users
Secrets will only be viewable after creation. After that, they will not be viewable.
API key table will show the last_used_at timestamp
Name field is to identify what the token will be used for
Currently creating a user or visiting this page generates a token automatically. This ticket makes the key generation of tokens explicit through the Create API key button only Authorization via API Keys will be deprecated in late 2024, therefore we recommend authorizing by the Apps option described above.
Generating a New API Key
If you need to generate a new API key as a Chain Admin:
Log in to Event Temple with your Chain Admin account.
Go to your profile settings by clicking on your user icon in the top-right corner.
Select the Chain option to access chain-level settings.
Navigate to the Developers section in the settings sidebar.
Under the Developers section, you can:
Generate a new API key.
Connect via Apps for further integrations if required.
Resolving Invalid API Keys
If your current API key is no longer valid or data transfer issues arise:
Log in with a Chain Admin account. API keys and integration functionality are only accessible to users with appropriate permissions.
Verify any changes in permissions or organizational structure which might necessitate generating a new API key.
Revisit the Developers section under the Chain profile settings and generate a new API key using the steps above.