Create access token with pin

General Information

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

Description

This API allows the user to login by pin or enable pin login and create a token.

Input

Type: application/json

Name	Source	Mandatory	Type	Special Format	Description
pin	Body	NO	String	N/A	Pin
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
451	Pin login is not available for this account