Zoho

Zoho Settings API

The Settings API from Zoho — 107 operation(s) for settings.

GitHub OpenAPI

Operations 213

GET /settings/duplicate_check_preference Get Duplicate Check Preference #
POST /settings/duplicate_check_preference Create Duplicate Check Preference #
PUT /settings/duplicate_check_preference Update Duplicate Check Preference #
DELETE /settings/duplicate_check_preference Delete Duplicate Check Preference #
GET /settings/global_picklists Get all global picklists #
POST /settings/global_picklists Create a new global picklist #
GET /settings/global_picklists/{id} Get a single global picklist by id #
PATCH /settings/global_picklists/{id} Update a global picklist by id #
DELETE /settings/global_picklists/{id} Delete a global picklist by id #
GET /settings/global_picklists/{id}/actions/pick_list_values_associations Get picklist value associations #
GET /settings/user_groups Get Groups #
POST /settings/user_groups Create Group #
GET /settings/user_groups/{group} Get Group #
PUT /settings/user_groups/{group} Update Group #
DELETE /settings/user_groups/{group} Delete Group #
GET /settings/user_groups/{group}/sources Get Sources #
GET /settings/user_groups/{group}/actions/sources_count Get Sources Count #
GET /settings/user_groups/actions/associated_users_count Get Associated Users Count #
GET /settings/user_groups/{group}/actions/associations Get Group associations #
GET /settings/roles Get all roles #
POST /settings/roles Create new roles #
PUT /settings/roles Update multiple roles #
GET /settings/roles/{role} Get specific role #
PUT /settings/roles/{role} Update role #
DELETE /settings/roles/{role} Delete role #
GET /settings/variable_groups GET /settings/variable_groups #
PUT /settings/variable_groups PUT variable_groups #
GET /settings/variable_groups/{id} GET variable_groups by {id} #
PUT /settings/variable_groups/{id} PUT by variable_groups by id #
GET /settings/portals/{portal}/user_type List portal user types #
POST /settings/portals/{portal}/user_type Create portal user type #
GET /settings/portals/{portal}/user_type/{userTypeId} Get portal user type #
PUT /settings/portals/{portal}/user_type/{userTypeId} Update portal user type #
DELETE /settings/portals/{portal}/user_type/{userTypeId} Delete portal user type #
GET /settings/email_templates Retrieve email templates list #
GET /settings/automation/webhooks GET /settings/automation/webhooks #
PUT /settings/automation/webhooks PUT /settings/automation/webhooks #
POST /settings/automation/webhooks POST /settings/automation/webhooks #
DELETE /settings/automation/webhooks DELETE /settings/automation/webhooks #
GET /settings/automation/webhooks/{webhookId} GET /settings/automation/webhooks/{webhookId} #
PUT /settings/automation/webhooks/{webhookId} PUT /settings/automation/webhooks #
DELETE /settings/automation/webhooks/{webhookId} DELETE /settings/automation/webhooks/{webhookId} #
GET /settings/automation/webhook_failures GET /settings/automation/webhook_failures #
GET /settings/automation/webhooks/actions/associated_modules GET /settings/automation/webhooks/actions/associated_modules #
GET /settings/automation/webhooks/actions/usage_reports GET /settings/automation/webhooks/actions/usage_reports #
GET /settings/related_lists Retrieve related lists configuration #
POST /settings/business_hours Create business hours configuration #
PUT /settings/business_hours Update business hours configuration #
GET /settings/business_hours Retrieve business hours configuration #
POST /settings/automation/workflow_rules Configure a Workflow rule #
PUT /settings/automation/workflow_rules Update Workflow Rule For the Given ID in Body #
GET /settings/automation/workflow_rules Get All WorkflowRules #
DELETE /settings/automation/workflow_rules Delete Multiple Workflow Rules #
PUT /settings/automation/workflow_rules/{id} Update Workflow Rule By ID #
GET /settings/automation/workflow_rules/{id} Retrieve a single workflow #
DELETE /settings/automation/workflow_rules/{id} Delete Workflow Rule By ID #
GET /settings/automation/workflow_rules/actions/actions_count Get Workflow Rule actions count #
GET /settings/automation/workflow_rules/actions/module_specific_count Get Workflow Rule actions count for each module #
GET /settings/automation/workflow_rules/actions/rules_count Get Workflow Rules count #
GET /settings/automation/workflow_rules/{workflowRuleId}/actions/usage To retrieve Workflow Rule usage #
PUT /settings/automation/workflow_rules/actions/reorder To reorder workflow rules #
GET /settings/automation/tasks GET /settings/automation/tasks #
POST /settings/automation/tasks POST /settings/automation/tasks #
DELETE /settings/automation/tasks DELETE /settings/automation/tasks #
GET /settings/automation/tasks/{id} GET /settings/automation/tasks/{id} #
PUT /settings/automation/tasks/{id} PUT /settings/automation/tasks/123445566 #
DELETE /settings/automation/tasks/{id} DELETE /settings/automation/tasks/{id} #
GET /settings/recycle_bin List recycle bin records #
DELETE /settings/recycle_bin Delete multiple recycle bin records #
POST /settings/recycle_bin/actions/restore Restore multiple recycle bin records #
GET /settings/recycle_bin/actions/count Get recycle bin counts #
POST /settings/recycle_bin/actions/empty Empty the recycle bin #
POST /settings/recycle_bin/{recordId}/actions/restore Restore a recycle bin record #
GET /settings/recycle_bin/{recordId} Get a recycle bin record #
DELETE /settings/recycle_bin/{recordId} Delete a recycle bin record #
GET /settings/service_preferences Retrieve service preference settings for the organization #
PUT /settings/service_preferences Update service preference settings for the organization #
GET /settings/automation/scoring_rules GET /settings/automation/scoring_rules #
PUT /settings/automation/scoring_rules PUT /settings/automation/scoring_rules #
POST /settings/automation/scoring_rules POST /settings/automation/scoring_rules #
DELETE /settings/automation/scoring_rules DELETE /settings/automation/scoring_rules #
GET /settings/automation/scoring_rules/{ruleId} GET /settings/automation/scoring_rules/{ruleId} #
PUT /settings/automation/scoring_rules/{ruleId} PUT /settings/automation/scoring_rules/{ruleId} #
DELETE /settings/automation/scoring_rules/{ruleId} DELETE /settings/automation/scoring_rules/{ruleId} #
PUT /settings/automation/scoring_rules/{ruleId}/actions/activate PUT /settings/automation/scoring_rules/{ruleId}/actions/activate #
DELETE /settings/automation/scoring_rules/{ruleId}/actions/activate DELETE /settings/automation/scoring_rules/{ruleId}/actions/activate #
POST /settings/automation/scoring_rules/{ruleId}/actions/clone POST /settings/automation/scoring_rules/{ruleId}/actions/clone #
POST /settings/layouts/{id}/actions/activate Activate layout with profile associations #
DELETE /settings/layouts/{id}/actions/activate Deactivate layout with configuration transfer #
GET /settings/automation/assignment_rules GET /settings/automation/assignment_rules #
GET /settings/automation/assignment_rules/{id} GET /settings/automation/assignment_rules/1234567890 #
GET /settings/profiles List CRM profiles #
POST /settings/profiles/{id}/actions/clone Clone a CRM profile #
PUT /settings/profiles/{id} Update a CRM profile #
GET /settings/profiles/{id} Get a CRM profile #
DELETE /settings/profiles/{id} Delete a CRM profile #
GET /settings/automation/field_updates To retrieve all field updates #
POST /settings/automation/field_updates To create a field update action #
DELETE /settings/automation/field_updates To delete multiple field update actions #
GET /settings/automation/field_updates/{id} To retrieve a field update action by fieldUpdate ID #
PUT /settings/automation/field_updates/{id} To update an existing field update action #
DELETE /settings/automation/field_updates/{id} To delete a fieldupdate action #
GET /settings/business_hours/shift_hours Retrieve all shift hours #
POST /settings/business_hours/shift_hours Create new shifts #
PUT /settings/business_hours/shift_hours Update multiple shift hours #
GET /settings/business_hours/shift_hours/{shift} Retrieve a specific shift hour #
PUT /settings/business_hours/shift_hours/{shift} Update a specific shift hour #
DELETE /settings/business_hours/shift_hours/{shift} Delete a specific shift hour #
GET /settings/inventory_templates Retrieve inventory templates list #
GET /settings/wizards Get all wizards with basic details #
GET /settings/fields Get Fields #
POST /settings/fields Create Fields #
PATCH /settings/fields Update Fields #
GET /settings/fields/{fieldId} Get Field by ID #
PATCH /settings/fields/{fieldId} Update Field by ID #
DELETE /settings/fields/{fieldId} Delete Custom Field #
GET /settings/portals Get portals #
POST /settings/portals Create portals #
GET /settings/portals/{portal} Get portal details #
PUT /settings/portals/{portal} Update portal #
DELETE /settings/portals/{portal} Delete portal #
GET /settings/territories/{territory}/users List territory users #
PUT /settings/territories/{territory}/users Add users #
DELETE /settings/territories/{territory}/users Remove users #
GET /settings/territories/{territory}/users/{user} Get user details #
PUT /settings/territories/{territory}/users/{user} Add specific user #
DELETE /settings/territories/{territory}/users/{user} Remove user #
GET /settings/layouts/{layoutId}/map_dependency Retrieve field dependencies for a layout #
POST /settings/layouts/{layoutId}/map_dependency Create a new field dependency for a layout #
GET /settings/layouts/{layoutId}/map_dependency/{dependencyId} Retrieve a specific field dependency by ID #
PUT /settings/layouts/{layoutId}/map_dependency/{dependencyId} Update an existing field dependency #
DELETE /settings/layouts/{layoutId}/map_dependency/{dependencyId} Delete a field dependency #
GET /settings/call_preferences To get the Call preferences of the user #
PUT /settings/call_preferences Updating Call preference #
POST /settings/record_locking_configurations Create Record Locking Configuration #
PUT /settings/record_locking_configurations Update Record Locking Configuration #
GET /settings/record_locking_configurations Get Record Locking Configuration Details #
DELETE /settings/record_locking_configurations Delete Record Locking Configuration #
PUT /settings/record_locking_configurations/{id} Update Record Locking Configuration by ID #
GET /settings/record_locking_configurations/{id} Get Record Locking Configuration by ID #
DELETE /settings/record_locking_configurations/{id} Delete Record Locking Configuration by ID #
GET /settings/portals/{portal}/user_type/{userType}/users List portal users #
DELETE /settings/portals/{portal}/user_type/{userType}/users delete portal users #
POST /settings/portals/{portal}/user_type/{userType}/users/action/transfer Transfer portal users from one user group to another #
POST /settings/portals/{portal}/user_type/{userType}/users/{recordId}/actions/change_status Change status of portal users #
POST /settings/portals/{portal}/user_type/{userType}/users/actions/change_status Change status of portal users in bulk #
GET /settings/fiscal_year GET /settings/fiscal_year #
PUT /settings/fiscal_year PUT /settings/fiscal_year #
GET /settings/modules Retrieve CRM module metadata #
POST /settings/modules Create a custom CRM module #
PUT /settings/modules Update CRM modules #
GET /settings/modules/{moduleIdentifier} Get module metadata by API name #
PUT /settings/modules/{moduleIdentifier} Update module labels and profiles #
GET /settings/layouts Get all layouts metadata for a module #
GET /settings/layouts/{id} Get a specific layout metadata by ID #
DELETE /settings/layouts/{id} Delete a custom layout #
GET /settings/variables GET /settings/variables #
PUT /settings/variables PUT /settings/variables #
POST /settings/variables POST /settings/variables #
DELETE /settings/variables DELETE /settings/variables #
GET /settings/variables/{id} GET /settings/variables/1234567890 #
PUT /settings/variables/{id} PUT /settings/variables/1234567890 #
DELETE /settings/variables/{id} DELETE /settings/variables/1234567890 #
GET /settings/unsubscribe_links/{id} GET /settings/unsubscribe_links/111111000000115718 #
PUT /settings/unsubscribe_links/{id} PUT /settings/unsubscribe_links/111111000000115722 #
DELETE /settings/unsubscribe_links/{id} DELETE /settings/unsubscribe_links/111111000000115722 #
GET /settings/unsubscribe_link/actions/associations GET /settings/unsubscribe_link/actions/associations #
GET /settings/tags this endpoint is used to get tags from a module #
PUT /settings/tags PUT /settings/tags #
POST /settings/tags POST /settings/tags #
PUT /settings/tags/{id} PUT /settings/tags/{id} #
DELETE /settings/tags/{id} DELETE /settings/tags/{id} #
POST /settings/tags/actions/mass_delete Schedule mass delete tags job #
GET /settings/tags/actions/mass_delete Get status of mass delete job #
GET /settings/automation/cadences GET - Get all cadences #
GET /settings/territories Get all territories #
POST /settings/territories Create Territories #
PUT /settings/territories Update Territory #
DELETE /settings/territories Delete Territories #
GET /settings/territories/{id} Get Territory #
PUT /settings/territories/{id} Update Territory #
DELETE /settings/territories/{id} Delete Territory By Id #
POST /settings/territories/actions/transfer_and_delete Transfer And Delete Territories #
POST /settings/territories/{id}/actions/transfer_and_delete Transfer And Delete Territory By Id #
GET /settings/territories/{id}/__child_territories Get Child Territories By Id #
GET /settings/territories/actions/associated_users_count Get Associated Users Count #
GET /settings/data_sharing Get Data Sharing #
PUT /settings/data_sharing Update Data Sharing #
GET /settings/pipeline Get Pipelines #
POST /settings/pipeline Create Pipeline #
PATCH /settings/pipeline UpdateOrDelete Pipeline #
PUT /settings/pipeline UpdateOrDelete Pipeline #
GET /settings/pipeline/{id} Get Pipeline #
PATCH /settings/pipeline/{id} UpdateOrDelete Pipeline #
PUT /settings/pipeline/{id} UpdateOrDelete Pipeline #
POST /settings/pipeline/actions/transfer Transfer and Delete Pipelines #
GET /settings/appointment_preferences Retrieve Appointment Preferences #
PUT /settings/appointment_preferences Update Appointment Preferences #
GET /settings/fields/{fieldId}/pick_list_values Retrieve pick list values for a field #
GET /settings/custom_views Get All Custom Views #
GET /settings/custom_views/{id} Get Custom View By Id #
PUT /settings/custom_views/actions/change_sort Change Sort Order #
PUT /settings/custom_views/{id}/actions/change_sort Change Sort Order #
GET /settings/zia/data_enrichment get Zia Enrichment Configuration for a specific module #
GET /settings/emails/actions/from_addresses Get From Addresses #
GET /settings/tags/{id}/actions/records_count GET /settings/tags/{id}/actions/records_count #
POST /settings/tags/{id}/actions/merge POST /settings/tags/{id}/actions/merge #
POST /settings/audit_log_export Create an Audit Log Export job #
GET /settings/audit_log_export Get Exported AuditLogs #
GET /settings/audit_log_export/{id} Get Exported AuditLogs #

Documentation

📖
Documentation
https://www.zoho.com/crm/developer/docs/api/
📖
APIReference
https://www.zoho.com/crm/developer/docs/api/v8/
📖
GettingStarted
https://www.zoho.com/crm/developer/docs/
📖
Documentation
https://desk.zoho.com/DeskAPIDocument
📖
Documentation
https://www.zoho.com/analytics/api/v2/introduction.html
📖
APIReference
https://www.zoho.com/analytics/api/v2/
📖
Documentation
https://www.bigin.com/developer/docs/apis/v2/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho/refs/heads/main/openapi/zoho-settings-api-openapi.yml

Code Examples

💻
CodeExamples
https://github.com/zoho/ZohoDesk-PortalSDK-Sample-apps-iOS
💻
CodeExamples
https://github.com/zoho/ZohoDesk-PortalSDK-sample-apps-android
💻
CodeExamples
https://github.com/zoho/ZohoDesk-PortalSDK-sample-apps-flutter
💻
CodeExamples
https://github.com/zoho/ZohoDesk-PortalSDK-sample-apps-reactnative
💻
CodeExamples
https://github.com/zoho/Zoho-Desk-ASAP-Mobile-SDK-API-Samples
💻
CodeExamples
https://github.com/zoho/analytics-codestudio

Other Resources

🔗
SDKs
https://packagist.org/packages/zohocrm/php-sdk-8.0
🔗
SDKs
https://pypi.org/project/zohocrmsdk8-0/
🔗
SDKs
https://www.nuget.org/packages/ZOHOCRMSDK-8.0/
🔗
SDKs
https://github.com/zoho/zohocrm-java-sdk-8.0
🔗
SDKs
https://www.npmjs.com/package/@zohocrm/nodejs-sdk-8.0
🔗
SDKs
https://www.npmjs.com/package/@zohocrm/typescript-sdk-8.0
🔗
SDKs
https://rubygems.org/gems/ZOHOCRMSDK8_0
🔗
SDKs
https://github.com/zoho/zohocrm-javascript-sdk-8.0
🔗
SDKs
https://github.com/zoho/zohocrm-scala-sdk-8.0
🔗
SDKs
https://cocoapods.org/pods/ZCRMiOS
🔗
DeveloperPortal
https://www.zoho.com/desk/developers/
🔗
SDKs
https://github.com/zoho/ZohoDeskPortalSDK
🔗
SDKs
https://github.com/zoho/react-native-zohodesk-portal-sdk
🔗
SDKs
https://github.com/zoho/zdesk-asap-flutter
🔗
SDKs
https://github.com/zoho/cordova-plugin-zohodesk-portal
🔗
Tools
https://github.com/zoho/analytics-mcp-server
🔗
Integrations
https://github.com/zoho/analytics-dataiku-import-plugin
🔗
Integrations
https://github.com/zoho/analytics-dataiku-export-plugin
🔗
DeveloperPortal
https://www.bigin.com/developer-center.html

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/zoho-settings-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

zoho-settings-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Helpcenter Settings API
  version: 1.0.0
tags:
- name: Settings
paths:
  /settings/duplicate_check_preference:
    get:
      summary: Get Duplicate Check Preference
      description: Get Duplicate Check Preference
      security:
      - iam-oauth2-schema:
        - ZohoCRM.settings.duplicate_check_preference.READ
      operationId: getDuplicateCheckPreference
      parameters:
      - $ref: '#/components/parameters/Module'
      responses:
        '200':
          description: Successful response with Duplicate Check Preference details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetDuplicateCheckPreference'
                x-zs-$id: GetDuplicateCheckPreference
        '204':
          description: If feature not enabled for the given module
      tags:
      - Settings
    post:
      summary: Create Duplicate Check Preference
      description: Create Duplicate Check Preference
      security:
      - iam-oauth2-schema:
        - ZohoCRM.settings.duplicate_check_preference.CREATE
      operationId: createDuplicateCheckPreference
      parameters:
      - $ref: '#/components/parameters/Module'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetDuplicateCheckPreference'
        required: true
      responses:
        '200':
          description: Successful response with Duplicate Check Preference details
          content:
            application/json:
              schema:
                description: Response wrapper object containing the duplicate check preference details.
                additionalProperties: false
                type: object
                properties:
                  duplicate_check_preference:
                    description: Details of the duplicate check preference configuration.
                    additionalProperties: false
                    type: object
                    properties:
                      code:
                        description: Status code indicating the result of the operation.
                        type: string
                        enum:
                        - SUCCESS
                      status:
                        description: Status of the operation.
                        type: string
                        enum:
                        - success
                      message:
                        description: Human-readable message providing additional information about the operation result.
                        maxLength: 100
                        type: string
                      details:
                        description: Additional details related to the operation.
                        additionalProperties: false
                        type: object
                required:
                - duplicate_check_preference
        '400':
          description: Bad Request - Invalid input or missing required parameters
          content:
            application/json:
              schema:
                oneOf:
                - type: object
                  description: Request-level error format (returned when request param is fundamentally malformed, e.g., missing 'module' parameter).
                  additionalProperties: false
                  properties:
                    status:
                      type: string
                      enum:
                      - error
                      description: Error status indicator.
                    code:
                      type: string
                      enum:
                      - REQUIRED_PARAM_MISSING
                      description: Machine-readable error code for request-level failures.
                    message:
                      type: string
                      enum:
                      - One of the expected parameter is missing.
                      description: Human-readable error message.
                    details:
                      type: object
                      additionalProperties: false
                      description: Contextual error details including field location.
                      properties:
                        param_name:
                          type: string
                          maxLength: 10
                          description: param_name that caused the error (e.g., 'module').
                      required:
                      - param_name
                  required:
                  - status
                  - code
                  - message
                  - details
                - type: object
                  description: Request-level error format (returned when feature not supported).
                  additionalProperties: false
                  properties:
                    status:
                      type: string
                      enum:
                      - error
                      description: Error status indicator.
                    code:
                      type: string
                      enum:
                      - FEATURE_NOT_SUPPORTED
                      description: Machine-readable error code for request-level failures.
                    message:
                      type: string
                      enum:
                      - Your License does not support this feature.
                      description: Human-readable error message.
                    details:
                      type: object
                      additionalProperties: false
                      description: Contextual error details including field location.
                  required:
                  - code
                  - message
                  - details
                  - status
                - type: object
                  description: Request-level error format (returned when feature not supported).
                  additionalProperties: false
                  properties:
                    code:
                      type: string
                      enum:
                      - NOT_SUPPORTED
                      description: Machine-readable error code for request-level failures.
                    message:
                      type: string
                      enum:
                      - The feature not avilable in the given module.
                      description: Human-readable error message.
                    details:
                      type: object
                      additionalProperties: false
                      description: Contextual error details including field location.
                      properties:
                        param_name:
                          type: string
                          maxLength: 10
                          description: param_name that caused the error (e.g., 'module').
                        api_name:
                          type: string
                          maxLength: 10
                          description: API name of the field with invalid data.
                        json_path:
                          type: string
                          maxLength: 100
                          description: JSONPath to the location of the invalid field.
                      required:
                      - param_name
                      - api_name
                      - json_path
                  required:
                  - code
                  - message
                  - details
                - type: object
                  description: Request-level error format (returned when feature not supported).
                  additionalProperties: false
                  properties:
                    code:
                      type: string
                      enum:
                      - ALREADY_CONFIGURED
                      description: Machine-readable error code for request-level failures.
                    message:
                      type: string
                      enum:
                      - already configured.
                      description: Human-readable error message.
                    details:
                      type: object
                      additionalProperties: false
                      description: Contextual error details including field location.
                  required:
                  - code
                  - message
                - type: object
                  description: AMBIGUITY_DURING_PROCESSING error response when conflicting parameters are provided (ids + api_names, or type + restricted_action).
                  additionalProperties: false
                  properties:
                    code:
                      type: string
                      description: Error code indicating parameter ambiguity.
                      enum:
                      - AMBIGUITY_DURING_PROCESSING
                    details:
                      type: object
                      description: Details about the ambiguous parameters.
                      additionalProperties: false
                      properties:
                        ambiguity_due_to:
                          type: array
                          maxItems: 2
                          description: Array of conflicting parameters that caused the ambiguity.
                          items:
                            type: object
                            description: Parameter that contributed to the ambiguity.
                            additionalProperties: false
                            properties:
                              api_name:
                                type: string
                                maxLength: 10
                                description: API field name that caused the error (e.g., 'tab_groups').
                              json_path:
                                type: string
                                maxLength: 100
                                description: JSONPath expression locating the error (e.g., '$.tab_groups').
                            required:
                            - api_name
                            - json_path
                      required:
                      - ambiguity_due_to
                    message:
                      type: string
                      description: Human-readable error message explaining the ambiguity.
                      maxLength: 1000
                    status:
                      type: string
                      description: Error status indicator.
                      enum:
                      - error
                  required:
                  - code
                  - details
                  - message
                  - status
                - type: object
                  description: MANDATORY_NOT_FOUND error when required fields are missing
                  additionalProperties: false
                  properties:
                    code:
                      type: string
                      description: Error code indicating a mandatory field is missing
                      enum:
                      - MANDATORY_NOT_FOUND
                    details:
                      type: object
                      description: Error details with field location information
                      additionalProperties: false
                      properties:
                        api_name:
                          type: string
                          maxLength: 50
                          description: Name of the required field that is missing
                        json_path:
                          type: string
                          description: JSONPath expression locating where the field should be in the request
                          maxLength: 100
                      required:
                      - api_name
                      - json_path
                    message:
                      type: string
                      description: Human-readable error message describing the missing required field
                      maxLength: 1000
                    status:
                      type: string
                      description: Error status indicator
                      enum:
                      - error
                  required:
                  - code
                  - details
                  - message
                  - status
                - type: object
                  description: DEPENDENT_FIELD_MISSING error when dependent configuration is missing
                  additionalProperties: false
                  properties:
                    code:
                      type: string
                      description: Error code indicating a dependent field is missing
                      enum:
                      - DEPENDENT_FIELD_MISSING
                    details:
                      type: object
                      description: Error details with field location information
                      additionalProperties: false
                      properties:
                        api_name:
                          type: string
                          maxLength: 50
                          description: Name of the dependent field that is missing
                        json_path:
                          type: string
                          description: JSONPath expression locating where the field should be in the request
                          maxLength: 100
                      required:
                      - api_name
                      - json_path
                    message:
                      type: string
                      description: Human-readable error message describing the missing dependent field
                      maxLength: 1000
                    status:
                      type: string
                      description: Error status indicator
                      enum:
                      - error
                  required:
                  - code
                  - details
                  - message
                  - status
                - type: object
                  description: EXPECTED_FIELD_MISSING error for missing expected fields
                  additionalProperties: false
                  properties:
                    code:
                      type: string
                      description: Error code for missing expected field
                      enum:
                      - EXPECTED_FIELD_MISSING
                    details:
                      type: object
                      description: Details about missing expected fields
                      additionalProperties: false
                      properties:
                        expected_fields:
                          type: array
                          maxItems: 10
                          description: List of fields that were expected but missing
                          items:
                            type: object
                            description: Field location details
                            additionalProperties: false
                            properties:
                              api_name:
                                type: string
                                description: API name of the expected field
                                minLength: 1
                                maxLength: 50
                              json_path:
                                type: string
                                description: JSONPath location where field was expected
                                minLength: 1
                                maxLength: 100
                            required:
                            - api_name
                            - json_path
                          minItems: 1
                      required:
                      - expected_fields
                    message:
                      type: string
                      description: Human-readable error message
                      minLength: 1
                      maxLength: 1000
                    status:
                      type: string
                      description: Status indicator for error
                      enum:
                      - error
                  required:
                  - code
                  - details
                  - message
                  - status
                - type: object
                  description: INVALID_DATA error for data validation failures
                  additionalProperties: false
                  properties:
                    code:
                      type: string
                      description: Error code indicating invalid or malformed data
                      enum:
                      - INVALID_DATA
                    details:
                      type: object
                      description: Error details with field information
                      additionalProperties: false
                      properties:
                        maximum_length:
                          type: integer
                          format: int32
                          description: Maximum allowed length for the field
                        expected_data_type:
                          type: string
                          maxLength: 50
                          description: Expected data type for the field
                        api_name:
                          type: string
                          description: Name of the field with invalid data
                          maxLength: 50
                        json_path:
                          type: string
                          description: JSONPath expression locating the invalid field in the request
                          maxLength: 100
                    message:
                      type: string
                      description: Human-readable error message describing the invalid data
                      maxLength: 1000
                    status:
                      type: string
                      description: Error status indicator
                      enum:
                      - error
                  required:
                  - code
                  - details
                  - message
                  - status
                - type: object
                  description: NOT_ALLOWED error for operations that are not permitted
                  additionalProperties: false
                  properties:
                    code:
                      type: string
                      description: Error code indicating operation is not allowed
                      enum:
                      - NOT_ALLOWED
                    details:
                      type: object
                      description: Error details with field location information
                      additionalProperties: false
                      properties:
                        api_name:
                          type: string
                          description: Name of the field or operation that is not allowed
                          maxLength: 50
                        json_path:
                          type: string
                          description: JSONPath expression locating the not-allowed field or operation
                          maxLength: 100
                      required:
                      - api_name
                      - json_path
                    message:
                      type: string
                      description: Human-readable error message explaining what is not allowed
                      maxLength: 1000
                    status:
                      type: string
                      description: Error status indicator
                      enum:
                      - error
                  required:
                  - code
                  - details
                  - message
                  - status
                - type: object
                  description: NOT_SUPPORTED error for unsupported operations
                  additionalProperties: false
                  properties:
                    code:
                      type: string
                      description: Error code for unsupported operation
                      enum:
                      - NOT_SUPPORTED
                    details:
                      type: object
                      description: Additional error details (typically empty)
                      additionalProperties: false
                      properties:
                        param_name:
                          type: string
                          maxLength: 10
                          description: param_name that caused the error (e.g., 'module').
                        api_name:
                          type: string
                          description: Name of the field or operation that is not allowed
                          maxLength: 50
                        json_path:
                          type: string
                          description: JSONPath expression locating the not-allowed field or operation
                          maxLength: 100
                    message:
                      type: string
                      description: Human-readable error message
                      minLength: 1
                      maxLength: 1000
                    status:
                      type: string
                      description: Status indicator for error
                      enum:
                      - error
                  required:
                  - code
                  - details
                  - message
                  - status
                - type: object
                  description: ALREADY_CONFIGURED error for unsupported operations
                  additionalProperties: false
                  properties:
                    code:
                      type: string
                      description: Error code for unsupported operation
                      enum:
                      - ALREADY_CONFIGURED
                      - NO_PERMISSION
                    details:
                      type: object
                      description: Additional error details (typically empty)
                      additionalProperties: false
                    message:
                      type: string
                      description: Human-readable error message
                      minLength: 1
                      maxLength: 1000
                    status:
                      type: string
                      description: Status indicator for error
                      enum:
                      - error
                  required:
                  - code
                  - details
                  - message
                  - status
                - type: object
                  description: INVALID_MODULE error for unsupported operations
                  additionalProperties: false
                  properties:
                    code:
                      type: string
                      description: Error code for unsupported operation
                      enum:
                      - INVALID_MODULE
                    details:
                      type: object
                      description: Additional error details (typically empty)
                      additionalProperties: false
                      properties:
                        param_name:
                          type: string
                          maxLength: 10
                          description: param_name that caused the error (e.g., 'module').
                    message:
                      type: string
                      description: Human-readable error message
                      minLength: 1
                      maxLength: 1000
                    status:
                      type: string
                      description: Status indicator for error
                      enum:
                      - error
                  required:
                  - code
                  - details
                  - message
                  - status
                - type: object
                  description: DEPENDENT_FIELD_MISSING error for unsupported operations
                  additionalProperties: false
                  properties:
                    code:
                      type: string
                      description: Error code for unsupported operation
                      enum:
                      - DEPENDENT_FIELD_MISSING
                    details:
                      type: object
                      description: Additional error details (typically empty)
                      additionalProperties: false
                      properties:
                        dependee:
                          type: object
                          description: param_name that caused the error (e.g., 'module').
                          additionalProperties: false
                          properties:
                            api_name:
                              type: string
                              maxLength: 50
                              description: API name of the dependee field
                            json_path:
                              type: string
                              maxLength: 100
                              description: JSON path of the dependee field
                          required:
                          - api_name
                          - json_path
                        api_name:
                          type: string
                          maxLength: 50
                          description: API name of the dependee field
                        json_path:
                          type: string
                          maxLength: 100
                          description: JSON path of the dependee field
                    message:
                      type: string
                      description: Human-readable error message
                      minLength: 1
                      maxLength: 1000
                    status:
                      type: string
                      description: Status indicator for error
                      enum:
                      - error
                  required:
                  - code
                  - details
                  - message
                  - status
      tags:
      - Settings
    put:
      summary: Update Duplicate Check Preference
      description: Update Duplicate Check Preference API is used to update duplicate check settings for a specific module in the CRM system. It allows users to define how duplicate records are identified and managed based on field mappings between the current module and a mapped module, such as Contacts. This API helps maintain data integrity by preventing the creation of duplicate records during data entry or import processes.
      security:
      - iam-oauth2-schema:
        - ZohoCRM.settings.duplicate_check_preference.UPDATE
      operationId: updateDuplicateCheckPreference
      parameters:
      - $ref: '#/components/parameters/Module'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              description: Request Body for Update Duplicate Check Preference
              additionalProperties: false
              properties:
                duplicate_check_preference:
                  type: object
                  description: Duplicate Check Preference details
                  additionalProperties: false
                  properties:
                    type:
                      type: string
                      description: Type of duplicate check preference
                      enum:
                      - mapped_module_records
                      - converted_records
                    type_configurations:
                      type: array
                      description: Type configurations for duplicate check preference
                      maxItems: 1
                      items:
                        type: object
                        description: Type configuration details
                        additionalProperties: false
                        properties:
                          field_mappings:
                            description: Field mappings between current module and mapped module
                            maxItems: 5
                            type: array
                            items:
                              type: object
                              description: Field mapping details
                              additionalProperties: false
                              properties:
                                current_field:
                                  type: object
                                  description: Field mappings between current module and mapped module
                                  additionalProperties: false
                                  properties:
                                    id:
                                      type: string
                                      description: Field mappings between current module and mapped module
                                      maxLength: 50
                                    api_name:
                                      type: string
                                      description: Field mappings between current module and mapped module
                                      maxLength: 50
                                    name:
                                      type: string
                                      description: Field mappings between current module and mapped module
                                      maxLength: 50
                                  required:
                                  - id
                                  - api_name
                                mapped_field:
                                  type: object
                                  description: Mapped field details
                                  additionalProperties: false
                                  properties:
                                    id:
                                      type: string
                                      description: Mapped field id
                                      maxLength: 50
                                    api_name:
                                      type: string
                                      description: Mapped field API name
                                      maxLength: 50
                                    name:
                                      type: string
                                      description: Field mappings between current module and mapped module
                                      maxLength: 50
                                  required:
                                  - id
                                  - api_name
                              required:
                              - current_field
                              - mapped_field
                          mapped_module:
                            type: object
                            description: Mapped module details
                            additionalProperties: false
                            properties:
                              id:
                                type: string
                                description: Mapped module id
                                maxLength: 50
                              name:
                                type: string
                                description: Mapped module id
                                maxLength: 50
                              api_name:
                                type: string
                                description: Mapped module API name
                                maxLength: 50
                                enum:
                                - Contacts
                            required:
                            - id
                            - api_name
                        required:
                        - field_mappings
                        - mapped_module
                  required:
                  - type
                  - type_configurations
              required:
              - duplicate_check_preference
        required: true
      responses:
        '200':
          description: put api success response
      

# --- truncated at 32 KB (2299 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/zoho/refs/heads/main/openapi/zoho-settings-api-openapi.yml