Nxsys API Documentation
  1. Authentication
Nxsys API Documentation
  • Introduction
    • Nxsys API Documentation
    • Base URL and Environments
    • Handling Errors
    • Pagination
    • Best Practices
  • Authentication
    • Overview
    • Step 1: Create a Client Application
    • Step 2: Obtain Authorization Code
    • Step 3: Exchange your Authorization Code for an Access Token
    • Step 4: Refresh your Access Token
  • APIs
    • Authentication
      • Construct the Authorization URL
      • Exchange your Authorization Code for an Access Token
    • Candidates
      • Create Candidate
      • Get Candidates
      • Update Candidate
    • VAT Codes
      • Get Default VAT Codes
    • PaymentRate
      • Create Payment Rate
      • Get Payment Rates
      • Get Single Payment Rate
      • Update Payment Rate
    • Timesheet
      • Create Timesheet
      • Get Timesheets
      • Get Single Timesheet
      • Update Timesheet
    • Payslips
      • Get Payslips
  1. Authentication

Step 1: Create a Client Application

An active account on either the Nxsys or Payroll system is required to create a client application.
If you don't have an account, you can request one by contacting the Nxsys team.
Once your account is active, you can create a client application by following these steps.
Ensure that you select the appropriate system guideline from the tab below.
Nxsys Umbrella System
Nxsys Payroll System
1. Log in to the Nxsys Admin: https://portal.nxsys.tech
For more details about the url, please refer to Base URL and Environments
2. Go to Employers Management
image.png
3. Select the Employer
image.png
4. Select the Client Applications tab
image.png
5. Fill in the required fields and click on "Create"
image.png
Name: The name of the client application.
Redirect URIs: The URLs to redirect to after authentication. You can add multiple URLs by clicking on the + button.
If you don't have a domain name, you can use dummy values in their place and register your client.
6. Copy the Client ID and Client Secret
image.png
Client ID is used to identify the client application.
Client Secret is used to authenticate the client application.
These credentials are used in Step 2: Obtain Authorization Code.
📌
Client Secret is a sensitive information. Do not share it with anyone and keep it in a secure location.
Previous
Overview
Next
Step 2: Obtain Authorization Code
Built with