Register a Kustomer OAuth App
Register a private app with the Kustomer Apps Platform to obtain OAuth credentials.
Obtain an Admin API Key
Go to your Kustomer instance at https://<your-org>.kustomerapp.com.
- Navigate to Settings > Security > API Keys.
- Click Add API Key.
- Assign the org.admin.apps and org.permission.apps roles.
- Copy the API key immediately — it is only shown once.
Register the App
Use the API key to register your app via POST request to the Kustomer Apps Platform API.
- Send a POST request to
https://api.kustomerapp.com/v1/apps/availablewith your app definition JSON. - Include a unique app identifier and semantic version in the request body.
- Set the redirect URI to
https://api.stackone.com/connect/oauth2/kustomer/callback.
Generate OAuth Credentials
After registering the app, generate the Client ID and Client Secret.
- Send a POST request to
https://api.kustomerapp.com/v1/apps/available/{app}/secret/to generate credentials. - Copy the Client ID and Client Secret — store them securely.
Find Your Organization Name
Your Kustomer organization name is needed for the base URL.
Locate from your browser URL
After logging in to Kustomer, look at the URL in your browser address bar. It follows the format https://<org-name>.kustomerapp.com.
- Organization Name is the subdomain before
.kustomerapp.com(e.g.,mycompany).
Install the App
The OAuth app must be installed in the target organization before authorization can begin.
Install the App
Install the registered app in the Kustomer organization. Without this step, the OAuth flow will return a 400 ‘Invalid Client’ error.
Link the Account
Connect
- Click Connect.
- If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
- Once authorization is successful, you will see a confirmation popup.
Use Actions