Create access token

General Information

Service	API	Method	Data Models	Workflow
oauth	/token	POST	N/A	N/A

Description

This API allows the user to login and create a token.

Input

Type: application/json

Name	Source	Mandatory	Type	Special Format	Description
username	Body	NO	String	N/A	Username
password	Body	NO	String	N/A	Password
grant_type	Body	YES	String	"enum": ["refresh_token", "password"]	Grant Type
refresh_token	Body	NO	String	N/A	Refresh token

Output

Response

SOAJS has a unified response. Check out this link to understand more the schema of SOAJS response

Valid Response

Valid Response Sample

{
    "token_type": "bearer",
    "access_token": "%oauth_access_token_value%",
    "expires_in": 3600,
    "refresh_token": "%oauth_refresh_token_value%"
}

Invalid Response

Error Response Sample

{
    "result":false,
    "errors":{
        "codes":[406],
        "details":[
            {
                "code":406,
                "message":"Missing Tenant secret"
            }
        ]
    }
}

Response schema

Follow this link to check out the response JSON Schema

SOAJS Error Codes

Code	Description
406	Missing Tenant secret
503	You do not have privileges to enable pin login
503	Unable to log in the user. User not found