Skip to main content
Admin privileges are required on your Zelt account.

​
Create OAuth app

Register an OAuth application in the Zelt Developer hub to obtain the Client ID and Client Secret StackOne uses to connect.

1

Sign in and open Security settings

Sign in to Zelt, then open your organisation’s security settings.

  • Sign in to your Zelt account.
  • Open Settings (the gear ⚙ icon at the bottom of the left sidebar).
  • Under Organisation, select Security.
The Settings menu with Organisation and Security highlighted
2

Open the Developer hub

On the Security page, open the Developer hub card (labelled “Build integrations and publish apps for Zelt”).

The Security page with the Developer hub card highlighted
3

Create a new app

On the Build apps page, click New app to open the app creation drawer.

The Build apps page with the New app button highlighted
4

Fill in the application details

In the New app drawer, complete the fields, then click Generate.

  • Name: for example StackOne Service Credentials (choose any name you prefer).
  • Description: for example Service authorization for StackOne integration.
  • Redirection URI: enter StackOne’s callback URL exactly: https://api.stackone.com/connect/oauth2/zelt/callback
  • Click Generate to create the app.
The New app drawer with the Name, Description and Redirection URI fields filled in and the Generate button highlighted
5

Copy your credentials

After you click Generate, Zelt displays the new app credentials once. Copy them and store them securely.

  • Copy the Client ID and paste it into the Client ID field in the StackOne Connector profile.
  • Copy the Client secret and paste it into the Client Secret field in the StackOne Connector profile.
  • The Client secret is only shown to you now and cannot be retrieved later — note it down safely before closing this screen. Do not copy the App ID, which is a different value.
The app credentials screen showing the App ID, Client ID and Client secret (values redacted)
6

Set the app permissions

Enables actions: Bulk Import Attendance Entries, Create New User Contract, Create New User Role Record, Create User, Create User Compensation, Delete User Compensation, Delete User Contract Record, Delete User Role Record, Get Current User Contract By User ID, Get Currently Effective Compensation Details, Get Currently Effective User Address, Get Currently Effective User Event, Get Currently Effective User Role, Get User Addresses By User ID, Get User Basic Details, Get User Compensation Details, Get User Contracts By User ID, Get User Events, Get User Personal Info, Get User Role Details, List Absences, List All Departments For Company, List All Job Levels, List All Job Positions, List All Sites For Company, List All Users, List Document Types For Company, List Permission Group Members, Rehire User, Update User Basic Details, Update User Compensation, Update User Contract Record, Update User Personal Info, Update User Role Record

Open the Permissions tab for your app and add the scopes the integration needs.

  • Open your app from the Build apps list, then select the Permissions tab.
  • Click the pencil (edit) icon, select the scopes required for the actions you plan to use, provide a reason for each, and save your changes.
The app Permissions tab with the edit (pencil) icon highlighted

​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Zelt:
1

Navigate to Connector Profiles

Login to StackOne and navigate to Connector Profiles
2

Create New Connector Profile

  • Click + Connector Profile
  • Search for and select Zelt
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile
Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for Zelt.