How to register your own Perk OAuth app
Register an OAuth app with Perk and obtain credentials to connect it to Tenklo
This guide shows you how to register your own app with Perk to obtain your OAuth credentials (client ID & secret). These are required to let your users grant your app access to their Perk account.
Create an OAuth application in Sandbox
Sandbox accounts are self-serve — go to the Perk Sandbox signup to create one instantly, no approval needed. Then create a new OAuth Integration. You will need to provide:
- The name of your tool/website/project
- A redirect URL — set this to
https://api.tenklo.dev/oauth/callback - A logo image
- The API endpoints you will be using
Perk will provide you with a Client ID and a Client Secret.
The Sandbox environment lets you develop and test your integration before going live.
When setting up your OAuth app, select only the scopes your application needs. Each scope consists of an API name and a permission separated by :, for example: bookings:read trips:read expenses:read.
Perk will confirm the list of scopes available to your application during the app creation process.
Unlike Sandbox, production access isn't self-serve: once your integration is ready, contact [email protected] so Perk's team can review and publish your OAuth Application, making it available to all Perk customers.
When connecting in Tenklo, select the matching Environment (Sandbox or Production) for each connection — see the connect guide for details.
Follow the Quickstart to connect your first account.
For more details, see Perk's OAuth documentation.