Permissions

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

⚠️

Warning

Do this before generating your authorization code. If you generate a token first and then add scopes, you must generate a new token. Existing tokens do not automatically gain new permissions.

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 (not an error).

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 and user.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.