Initiation Request

The client on a limited input device sends an Initiation request to Zoho Accounts on behalf of the user.

  • URI Endpoint: https://accounts.zoho.com/oauth/v3/device/code
  • HTTP Request Type: POST
  • Mandatory Parameters:
    • client_id - Obtained from registering your client at the Zoho Accounts developer console.
    • grant_type - Value must be 'device_request'.
    • Scope - Sample scope - "AaaServer.profile.READ"
  • Optional Parameters:
    • access_type - Value can be 'offline' or 'online'. If the value is offline, you will receive a refresh token along with an access token. You can use the access token to make API calls. You can use the refresh token to request for another access token after expiration.
    • prompt - Value must be 'consent.' If this parameter is included in the query, every time you request an access token using a refresh token the user's consent approval is mandatory.

Sample HTTP Request


				https://accounts.zoho.com/oauth/v3/device/code?
client_id=1000.GMB0YULZHJK411248S8I5GZ4CHUEX0&
scope=AaaServer.profile.READ&
grant_type=device_request			

Sample JSON Response


				{
    "user_code":"WLKU-4502",
    "device_code":"1004.d8a96b56e597e2x2966c418e07ee24ff.9cec9aed3",
    "interval":3000,
    "verification_url":"https://accounts.zoho.com/oauth/v3/device"
}