Skip to main content

Documentation Index

Fetch the complete documentation index at: https://nango.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

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.