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

Go to the Perk Sandbox and 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

Once your integration is ready, contact partners@perk.com to publish your OAuth Application to production and make it available to all Perk customers.
4

Next

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