OAuth Setup

Talenox API for Leave. OAuth 2.0.

Nicholas avatar
Written by Nicholas
Updated over a week ago

Talenox supports using OAuth 2.0 to grant third-party systems to access Talenox resources.

With OAuth 2.0 application, users are able to define their own permission for accessing the resources.

For more details, you can head over to the Talenox API documentation.


Where to find and create

  1. Login to Talenox, click on your user name at top right of the menu bar.

  2. Click on API Settings > developer page > New Application to create Oauth app in Talenox

  3. Fill in the following to generate client credentials:

    • Redirect URI: https://oauth.pstmn.io/v1/callback

    • Origin URI - Leave blank for postman. Note that this should be filled in for actual app setup and should be your app domain url.

    • scopes - e.g. leave or leave_read leave_write. Note that this space-delimited.

  4. Press submit. Note that you should save the client id and secret on your own to use in step 5, as you won’t be able to view the secret after this.

  5. Open Postman, click on Talenox Leave Api Demo and click “Variables

  6. In “Variables” tab, update initial values and current values based on your Oauth app created on Talenox:

    • CLIENT_ID

    • CLIENT_SECRET

    • OAUTH_SCOPE - e.g. leave or leave_read,leave_write,profile_read,profile_write

  7. Press save to save the values

  8. Test by running one of the endpoints. Click on “Get leave types” > click on “Authorization tab” and > click on “Get New Access Token

  9. You will see the Oauth prompt to select a company in your browser. Select a company and press ‘Authorize’.

  10. The browser will prompt you to open postman.app. Click “open postman.app” and press “proceed” when shown the Authorization complete prompt.

  11. Postman will show the token details like below. Press “Use token

  12. Press “Send” on Postman to run the api. You should see the response below:

  13. Access token has expiry duration (30 mins) and tokens will be refreshed on a periodic basis

Did this answer your question?