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
        GET
      • Exchange your Authorization Code for an Access Token
        POST
    • 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

Exchange your Authorization Code for an Access Token

Nxsys Umbrella - Production
https://api.nxsys.tech
Nxsys Umbrella - Production
https://api.nxsys.tech
POST
https://api.nxsys.tech
/nxsys/oauth/token
Exchanges an OAuth 2.0 authorization code or refresh token for a new access token and refresh token. This endpoint is used by client applications after the user has authorized access, allowing the application to obtain tokens for authenticated API requests. Supports both authorization_code and refresh_token grant types.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.nxsys.tech/nxsys/oauth/token' \
--data-urlencode 'code=add9180cfc9e89b8b8408cc02f9f1222' \
--data-urlencode 'clientId=NXSYS.ONZEYLYLO38TL9XEBE3JQUPGTYUQMZ7S' \
--data-urlencode 'clientSecret=8ffcf26dfe63a2576d7e1994e8307ed1cac09f845b62fb79' \
--data-urlencode 'redirectUri=https://yourapp.com/callback' \
--data-urlencode 'grantType=authorization_code'
Response Response Example
200 - Example 1
{
    "accessToken": "7eff18323a4695ec90aa4305c0cc6ee9793d4d3d65285b312e4c0d152b94ecd0",
    "refreshToken": "0c39535a7469f5b317154ee01768a8f0c431d078a10630e88189e9b913544f51",
    "expiresIn": 3600,
    "tokenType": "Nxsys-oauthtoken"
}

Request

Body Params application/x-www-form-urlencoded

Responses

🟢200OK
application/json
JWT access and refresh tokens
Body

🟠401Unauthorized
Previous
Construct the Authorization URL
Next
Create Candidate
Built with