Skip to main content
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.
1

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.nango.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.
2

Configure scopes

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.
3

Go to production

Unlike Sandbox, production access isn’t self-serve: once your integration is ready, contact partners@perk.com so Perk’s team can review and publish your OAuth Application, making it available to all Perk customers.When connecting in Nango, select the matching Environment (Sandbox or Production) for each connection — see the connect guide for details.
4

Next

Follow the Quickstart to connect your first account.
For more details, see Perk’s OAuth documentation.