Get Service Preferences

Purpose

To get the details of service preferences in your organization.

Endpoints

Request Details

Request URL

{api-domain}/crm/{version}/settings/service_preferences

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Scope

scope=ZohoCRM.settings.modules.{operation_type}

Possible operation types

ALL - Full access to service preferences data
READ - Retrieve service preferences

Sample Request

Copiedcurl "https://www.zohoapis.com/crm/v3/settings/service_preferences"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

Response JSON Keys

  • job_sheet_enabledBoolean

    Denotes whether the job sheet is enabled for your organization.
    Possible Values:
    true - Job Sheet is enabled. This is the default value.
    false - Job sheet is disabled.

Possible Errors

  • API_NOT_SUPPORTEDHTTP 400

    The API is not supported in this version.
    Solution: This API is supported only from Version 3.

  • INVALID_REQUEST_METHODHTTP 400

    You have given an invalid http request method type.
    Solution: Use only GET method in the request URL to access this API.

  • INVALID_TOKENHTTP 401

    You have used an invalid oauth token.
    Solution: The access token you used has expired. Kindly refresh your token and retry.

  • OAUTH_SCOPE_MISMATCHHTTP 401

    You created the grant token using the wrong oauth scope.
    Solution: Use either ZohoCRM.settings.modules.READ or ZohoCRM.settings.modules.ALL scope to create a new valid grant token.

  • INTERNAL_ERRORHTTP 500

    Internal Server Error
    Solution: Unexpected and unhandled exception in the server. Please contact our support team.

Sample Response

Copied{
    "service_preferences": {
        "job_sheet_enabled": true
    }
}