Permissions

Before your access token can access any data, you need to assign permissions to your app.

Before creating the authorisation code, you need to set the app's permissions. You need to assign permissions (scopes) to your app; scopes control which parts of Zelt your integration can read. If you don’t select any, the token will still be valid, but every API call will return empty results.

Select only what your integration really needs and provide a short Reason for each scope so other admins understand why it’s required.

1. In Zelt, go to Settings → Security → Developer Hub → Build Apps.
2. Select your app from the list.
3. Open the Permissions tab and click the edit button.
4. Choose the scopes your integration needs:
   • user:read:all anduser.basicInfo:read - general profile and basic user details
   • user.personalInfo:read / user.personalInfo:all - sensitive personal information
   • user.lifecycle:read:all - employment lifecycle data
   • user.contract:read:all - contract information
   • user.compensation:read:all - salary and compensation data
   • user.role:read:all - role and permissions in Zelt
   • company.settings:read - company-level settings
   • documents:all - access to documents stored in Zelt
5. For each selected permission, provide a short Reason explaining why your app requires it.
6. Click Update scopes to save.