Zoho Account API

openapi: 3.1.0
info:
  title: Helpcenter Account API
  version: 1.0.0
tags:
- name: Account
paths:
  /api/v1/accounts/{accountId}/associateProducts:
    post:
      tags:
      - Account
      summary: Associate products with an account
      description: This API associates products with an account. Only a maximum of 10 products can be associated with an account through a single API request.
      operationId: associateProductsWithAccount
      parameters:
      - $ref: '#/components/parameters/accountId'
      - $ref: ./Common.json#/components/parameters/orgId
      requestBody:
        $ref: '#/components/requestBodies/associateProductsWithAccount'
      responses:
        '200':
          $ref: ./MassActionResponse.json#/components/responses/massActionListResponse
        '422':
          $ref: ./Common.json#/components/responses/invalidDataErrorResponse
      security:
      - iam-oauth2-schema:
        - Desk.contacts.UPDATE
      x-audience:
      - external-public
  /api/v1/accounts/{accountId}/merge:
    post:
      tags:
      - Account
      summary: Merge Accounts
      description: This API merges two or more accounts.
      operationId: mergeAccounts
      parameters:
      - $ref: '#/components/parameters/accountId'
      - $ref: ./Common.json#/components/parameters/orgId
      requestBody:
        $ref: '#/components/requestBodies/accountMergeRequest'
      responses:
        '404':
          $ref: ./Common.json#/components/responses/urlNotFoundErrorResponse
        '200':
          $ref: '#/components/responses/accountResponse'
        '422':
          $ref: ./Common.json#/components/responses/multipleUnprocessEntityResponse
        '500':
          $ref: ./Common.json#/components/responses/internalErrorResponse
        '403':
          $ref: ./Common.json#/components/responses/forbiddenErrorResponse
      security:
      - iam-oauth2-schema:
        - Desk.contacts.UPDATE
      x-audience:
      - external-public
  /api/v1/contacts/{contactId}/accounts:
    get:
      tags:
      - Account
      summary: List accounts of contact
      description: This API lists the accounts associated with a particular contact.
      operationId: getAccountsByContact
      parameters:
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/from'
      - name: sortBy
        in: query
        description: 'Sort by a specific attribute: @accountName@ or @createdTime@ or @mappingType@ . The default sorting order is ascending. A @-@ prefix denotes descending order of sorting.'
        required: false
        style: form
        explode: true
        schema:
          type:
          - string
          - 'null'
          description: 'Sort by a specific attribute: @accountName@ or @createdTime@ or @mappingType@ . The default sorting order is ascending. A @-@ prefix denotes descending order of sorting.'
          enum:
          - accountName
          - createdTime
          - mappingType
      - $ref: '#/components/parameters/startsWith'
      - $ref: '#/components/parameters/contactId'
      - $ref: ./Common.json#/components/parameters/orgId
      responses:
        '204':
          $ref: ./Common.json#/components/responses/emptyResponse
        '200':
          $ref: '#/components/responses/accountListWithMappingInfoArray'
      security:
      - iam-oauth2-schema:
        - Desk.contacts.READ
      x-audience:
      - external-public
  /api/v1/accounts/{accountId}/statistics:
    get:
      tags:
      - Account
      summary: Get account statistics
      description: This API fetches the overall statistics of an account.
      operationId: getAccountStatistics
      parameters:
      - $ref: '#/components/parameters/departmentId'
      - $ref: '#/components/parameters/accountId'
      - $ref: ./Common.json#/components/parameters/orgId
      responses:
        '404':
          $ref: ./Common.json#/components/responses/urlNotFoundErrorResponse
        '200':
          $ref: ./Statistics.json#/components/responses/statisticsResponse
        '422':
          $ref: ./Common.json#/components/responses/invalidDataErrorResponse
        '401':
          $ref: ./Common.json#/components/responses/unauthorizedErrorResponse
      security:
      - iam-oauth2-schema:
        - Desk.contacts.READ
      x-audience:
      - external-public
  /api/v1/accounts/{accountId}/tickets:
    get:
      tags:
      - Account
      summary: List tickets by account
      description: This API lists tickets received from a specific account.
      operationId: getTicketsByAccount
      parameters:
      - name: include
        in: query
        description: 'Additional information related to the tickets. Values allowed are: contacts, products, departments, team, isRead and assignee. You can pass multiple values by separating them with a comma in the API request.'
        required: false
        style: simple
        explode: true
        schema:
          type:
          - 'null'
          - array
          description: 'Additional information related to the tickets. Values allowed are: @contacts@, @products@, @departments@, @team@, @isRead@ and @assignee@. You can pass multiple values by separating them with a comma in the API request.'
          items:
            type:
            - string
            - 'null'
            enum:
            - contacts
            - products
            - departments
            - team
            - assignee
            - isRead
            maxLength: 100
            minLength: 0
          uniqueItems: true
      - $ref: '#/components/parameters/departmentId'
      - name: dueDate
        in: query
        description: Filter by ticket duedate. Values allowed are @overdue@, @tomorrow@, @currentWeek@, @currentMonth@ and @today@. You can include both values by separating them with a comma
        required: false
        style: form
        explode: true
        schema:
          type:
          - string
          - 'null'
          description: Filter by ticket duedate. Values allowed are @overdue@, @tomorrow@, @currentWeek@, @currentMonth@ and @today@. You can include both values by separating them with a comma
          enum:
          - overdue
          - tomorrow
          - currentWeek
          - currentMonth
          - today
          maxLength: 100
          minLength: 0
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/from'
      - name: sortBy
        in: query
        description: 'Sort by a specific attribute: @createdTime@ or @modifiedTime@. The default sorting order is ascending. A @-@ prefix denotes descending order of sorting.'
        required: false
        style: form
        explode: true
        schema:
          type:
          - string
          - 'null'
          description: 'Sort by a specific attribute: @createdTime@ or @modifiedTime@. The default sorting order is ascending. A @-@ prefix denotes descending order of sorting.'
          enum:
          - createdTime
          - modifiedTime
          maxLength: 100
          minLength: 0
      - name: isSpam
        in: query
        description: Filters Spam tickets
        required: false
        style: form
        explode: true
        schema:
          type:
          - boolean
          - 'null'
          description: Filters Spam tickets
      - $ref: '#/components/parameters/accountId'
      - $ref: ./Common.json#/components/parameters/orgId
      responses:
        '204':
          $ref: ./Common.json#/components/responses/emptyResponse
        '200':
          $ref: '#/components/responses/getTicketsByAccountResponse'
      security:
      - iam-oauth2-schema:
        - Desk.tickets.READ
        - Desk.search.READ
      x-audience:
      - external-public
  /api/v1/accounts:
    get:
      tags:
      - Account
      summary: List accounts
      description: This API lists a particular number of accounts, based on the limit specified. 
      operationId: getAccounts
      parameters:
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/from'
      - name: sortBy
        in: query
        required: false
        style: form
        explode: true
        schema:
          type:
          - string
          - 'null'
          enum:
          - website
          - email
          - phone
          - accountName
          - createdTime
          - modifiedTime
          maxLength: 100
          minLength: 0
      - $ref: ./Common.json#/components/parameters/orgId
      responses:
        '200':
          $ref: '#/components/responses/accountListArray'
      security:
      - iam-oauth2-schema:
        - Desk.contacts.READ
      x-audience:
      - external-public
    post:
      tags:
      - Account
      summary: Create Account
      description: This API creates an account in your help desk portal.
      operationId: createAccount
      parameters:
      - $ref: ./Common.json#/components/parameters/orgId
      requestBody:
        $ref: '#/components/requestBodies/accountjson'
      responses:
        '422':
          $ref: ./Common.json#/components/responses/invalidDataErrorResponse
        '500':
          $ref: ./Common.json#/components/responses/internalErrorResponse
        '200':
          $ref: '#/components/responses/accountResponse'
      security:
      - iam-oauth2-schema:
        - Desk.contacts.CREATE
      x-audience:
      - external-public
  /api/v1/accounts/{accountId}/contracts:
    get:
      tags:
      - Account
      summary: Get contract
      description: Getting contracts of an Account
      operationId: getContractsByAccount
      parameters:
      - name: contractStatus
        in: query
        description: Contract Status,Indicates the Current Status of the Contract, Values are @ACTIVE@, @EXPIRED@, @FUTURE@
        required: false
        style: form
        explode: true
        schema:
          type:
          - string
          - 'null'
          description: Contract Status,Indicates the Current Status of the Contract, Values are @ACTIVE@, @EXPIRED@, @FUTURE@
          enum:
          - ACTIVE
          - EXPIRED
          - FUTURE
          maxLength: 100
          minLength: 0
      - $ref: '#/components/parameters/departmentId'
      - name: limit
        in: query
        description: Number of contracts to fetch, Ranges from 1-50, DEFAULT 50
        required: false
        style: form
        explode: true
        schema:
          type:
          - string
          - 'null'
          - integer
          format: int32
          default: 50
          description: Number of accounts to list
          maximum: 50
          minimum: 1
          pattern: ([0-9]+)
      - $ref: '#/components/parameters/from'
      - $ref: '#/components/parameters/accountId'
      - $ref: ./Common.json#/components/parameters/orgId
      responses:
        '200':
          $ref: '#/components/responses/getContractsForAccountResponse'
      security:
      - iam-oauth2-schema:
        - Desk.settings.READ
      x-audience:
      - external-public
  /api/v1/accounts/{accountId}:
    get:
      tags:
      - Account
      summary: Get Account
      description: This API fetches an account from your help desk portal.
      operationId: getAccount
      parameters:
      - name: include
        in: query
        description: 'Allowed values are :  @owner@'
        required: false
        style: simple
        explode: true
        schema:
          type:
          - 'null'
          - array
          description: 'Allowed values are :  @owner@'
          items:
            type:
            - string
            - 'null'
            enum:
            - owner
            maxLength: 100
            minLength: 0
          uniqueItems: true
      - $ref: '#/components/parameters/accountId'
      - $ref: ./Common.json#/components/parameters/orgId
      responses:
        '200':
          $ref: '#/components/responses/accountResponse'
      security:
      - iam-oauth2-schema:
        - Desk.contacts.READ
      x-audience:
      - external-public
    patch:
      tags:
      - Account
      summary: Update Account
      description: This API updates details of an existing account.
      operationId: updateAccount
      parameters:
      - $ref: '#/components/parameters/accountId'
      - $ref: ./Common.json#/components/parameters/orgId
      requestBody:
        $ref: '#/components/requestBodies/updateAccount_accountjson'
      responses:
        '200':
          $ref: '#/components/responses/accountResponse'
        '422':
          $ref: ./Common.json#/components/responses/invalidDataErrorResponse
      security:
      - iam-oauth2-schema:
        - Desk.contacts.UPDATE
      x-audience:
      - external-public
  /api/v1/accounts/{accountId}/history:
    get:
      tags:
      - Account
      summary: Get account history
      description: This API fetches the ticket history of an account.
      operationId: getTicketHistoryByAccount
      parameters:
      - name: agentId
        in: query
        description: Key that filters ticket activities performed by a particular agent
        required: false
        style: form
        explode: true
        schema:
          type:
          - string
          - 'null'
          - integer
          format: int64
          description: ' Key that filters ticket activities performed by a particular agent'
          pattern: ([0-9]+)
      - $ref: '#/components/parameters/contactId'
      - $ref: '#/components/parameters/departmentId'
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/from'
      - $ref: '#/components/parameters/accountId'
      - $ref: ./Common.json#/components/parameters/orgId
      responses:
        '404':
          $ref: ./Common.json#/components/responses/urlNotFoundErrorResponse
        '200':
          $ref: ./TicketHistory.json#/components/responses/accountContactHistoryResponse
        '422':
          $ref: ./Common.json#/components/responses/invalidDataErrorResponse
        '401':
          $ref: ./Common.json#/components/responses/unauthorizedErrorResponse
      security:
      - iam-oauth2-schema:
        - Desk.contacts.READ
        - Desk.tickets.READ
      x-audience:
      - external-public
  /api/v1/accounts/moveToTrash:
    post:
      tags:
      - Account
      summary: Delete Accounts
      description: This API moves the accounts specified to the Recycle Bin.
      operationId: deleteAccount
      parameters:
      - $ref: ./Common.json#/components/parameters/orgId
      requestBody:
        $ref: '#/components/requestBodies/accountsrecyclebinjson'
      responses:
        '422':
          $ref: ./Common.json#/components/responses/invalidDataErrorResponse
        '204':
          $ref: ./Common.json#/components/responses/emptyResponse
      security:
      - iam-oauth2-schema:
        - Desk.contacts.DELETE
      x-audience:
      - external-public
  /api/v1/products/{productId}/accounts:
    get:
      tags:
      - Account
      summary: List accounts associated with product
      description: This API lists the accounts associated with a product
      operationId: getAccountsByProduct
      parameters:
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/from'
      - name: sortBy
        in: query
        description: 'Key that sorts the accounts by a specific attribute: @accountName@ or @createdTime@.The default sorting order is ascending. A @-@ prefix denotes descending order of sorting'
        required: false
        style: form
        explode: true
        schema:
          type:
          - string
          - 'null'
          description: 'Key that sorts the accounts by a specific attribute: @accountName@ or @createdTime@.The default sorting order is ascending. A @-@ prefix denotes descending order of sorting'
          enum:
          - website
          - email
          - phone
          - accountName
          - createdTime
          - modifiedTime
          maxLength: 100
          minLength: 0
      - name: productId
        in: path
        required: true
        style: simple
        explode: false
        schema:
          type:
          - string
          - 'null'
          - integer
          format: int64
          pattern: ([0-9]+)
      - $ref: ./Common.json#/components/parameters/orgId
      responses:
        '204':
          $ref: ./Common.json#/components/responses/emptyResponse
        '200':
          $ref: '#/components/responses/accountListArray'
      security:
      - iam-oauth2-schema:
        - Desk.settings.READ
        - Desk.contacts.READ
      x-audience:
      - external-public
  /api/v1/accounts/updateMany:
    post:
      tags:
      - Account
      summary: Update many accounts
      description: This API updates multiple accounts at once.
      operationId: bulkUpdateAccounts
      parameters:
      - $ref: ./Common.json#/components/parameters/orgId
      requestBody:
        $ref: '#/components/requestBodies/account_massupdate'
      responses:
        '422':
          $ref: ./Common.json#/components/responses/invalidDataErrorResponse
        '200':
          $ref: '#/components/responses/updateManyResponse'
      security:
      - iam-oauth2-schema:
        - Desk.contacts.UPDATE
      x-audience:
      - external-public
components:
  responses:
    accountResponse:
      description: accountResponse template definitions
      content:
        application/json:
          schema:
            allOf:
            - type: object
              properties:
                owner:
                  type:
                  - 'null'
                  - object
                  additionalProperties: false
                  maxProperties: 3
                  minProperties: 3
                  properties:
                    firstName:
                      type:
                      - string
                      - 'null'
                      maxLength: 50
                      minLength: 0
                    lastName:
                      type:
                      - string
                      - 'null'
                      maxLength: 50
                      minLength: 0
                    id:
                      type:
                      - string
                      - 'null'
                      - integer
                      format: int64
                      pattern: ([0-9]+)
                  required:
                  - firstName
                  - id
                  - lastName
            - additionalProperties: false
              allOf:
              - $ref: ./Account.json#/components/schemas/accountjson
              - type:
                - 'null'
                - object
                properties:
                  modifiedTime:
                    type:
                    - string
                    - 'null'
                    maxLength: 100
                    minLength: 0
                    pattern: (((19|20)\d\d)[-/.]{1}(0?[1-9]|1[012])[-/.]{1}(0?[1-9]|[12][0-9]|3[01])(T)([01]?[0-9]|2[0-3]):[0-5]?[0-9]:[0-5]?[0-9]([/.][\d]{0,3})?(Z))
                  isFollowing:
                    type:
                    - boolean
                    - 'null'
                  isDeleted:
                    type:
                    - boolean
                    - 'null'
                  isTrashed:
                    type:
                    - boolean
                    - 'null'
                  associatedSLAIds:
                    type:
                    - 'null'
                    - array
                    items:
                      type:
                      - string
                      - 'null'
                      - integer
                      format: int64
                      pattern: ([0-9]+)
                    uniqueItems: false
                  webUrl:
                    type:
                    - string
                    - 'null'
                    maxLength: 500
                    minLength: 0
                    pattern: (^(ht|f)tp(s?)\://[-.\w]*(/?)([a-zA-Z0-9\-\.\?\,\:\'/\\+=&%\$#_@]*)?$)
                  createdTime:
                    type:
                    - string
                    - 'null'
                    maxLength: 100
                    minLength: 0
                    pattern: (((19|20)\d\d)[-/.]{1}(0?[1-9]|1[012])[-/.]{1}(0?[1-9]|[12][0-9]|3[01])(T)([01]?[0-9]|2[0-3]):[0-5]?[0-9]:[0-5]?[0-9]([/.][\d]{0,3})?(Z))
                  zohoCRMAccount:
                    $ref: ./Account.json#/components/schemas/zohoCrmAccount
                  id:
                    type:
                    - string
                    - 'null'
                    - integer
                    format: int64
                    pattern: ([0-9]+)
                  layoutId:
                    type:
                    - string
                    - 'null'
                    - integer
                    format: int64
                    pattern: ([0-9]+)
                  layoutDetails:
                    type:
                    - 'null'
                    - object
                    additionalProperties: false
                    maxProperties: 2
                    minProperties: 2
                    properties:
                      id:
                        type:
                        - string
                        - 'null'
                        - integer
                        format: int64
                        pattern: ([0-9]+)
                      layoutName:
                        type:
                        - string
                        - 'null'
                        maxLength: 120
                        minLength: 0
                        pattern: ([0-9a-zA-Z_\-\.\$@\?\,\:\'\/\!\P{InBasicLatin}\s])+
                    required:
                    - id
                    - layoutName
                required:
                - associatedSLAIds
                - createdTime
                - id
                - isDeleted
                - isFollowing
                - isTrashed
                - layoutDetails
                - layoutId
                - modifiedTime
                - webUrl
                - zohoCRMAccount
          examples:
            Valid responses Definitions:
              value:
                country: USA
                modifiedTime: 1425307758000
                code: '3211'
                accountName: Zylker
                city: null
                associatedSLAIds:
                - 3263000000057
                - 3000000057001
                description: null
                industry: Automation
                zohoCRMAccount:
                  id: '32754000000537001'
                ownerId: '3263000000057001'
                isDeleted: false
                isTrashed: false
                street: null
                annualrevenue: null
                createdTime: 1424105864000
                state: null
                id: '3263000000074571'
                fax: +1 444 8656 8732
                email: support@zylker.com
                owner:
                  firstName: Twin
                  lastName: john
                  id: '3263000000057001'
                website: www.zylker.com
                cf:
                  cf_contactcount: '1'
                isFollowing: 'true'
                phone: '6218129190'
                webUrl: https://desk.zoho.com/support/zylker/ShowHomePage.do#Accounts/dv/d126330fb061247d9ebddaeb9d93ba74750b0284bc703b38
    getContractsForAccountResponse:
      description: getContractsForAccountResponse template definitions
      content:
        application/json:
          schema:
            type:
            - 'null'
            - object
            additionalProperties: false
            properties:
              data:
                $ref: ./Account.json#/components/schemas/contractsForAccountData
            required:
            - data
          examples:
            Valid responses Definitions:
              value:
                data:
                - slaName: Priority-based SLAs
                  endDate: 1468627200000
                  slaGroupId: '4000000007069'
                  departmentId: '4000000007043'
                  contractId: '4000000032003'
                  contractNumber: '1212'
                  description: contract for all desk account
                  contractName: Contract for desk account
                  ownerId: '4000000008692'
                  startDate: 1466035200000
    updateManyResponse:
      description: updateManyResponse template definitions
      content:
        application/json:
          schema:
            oneOf:
            - type:
              - 'null'
              - object
              additionalProperties: false
              properties:
                results:
                  $ref: ./MassActionResponse.json#/components/schemas/results
              required:
              - results
            - additionalProperties: false
              allOf:
              - $ref: ./errors.json#/components/schemas/commonErrorResponse
              - type:
                - 'null'
                - object
                properties:
                  errors:
                    type:
                    - 'null'
                    - array
                    items:
                      type:
                      - 'null'
                      - object
                      additionalProperties: false
                      maxProperties: 3
                      minProperties: 3
                      properties:
                        fieldName:
                          type:
                          - string
                          - 'null'
                          maxLength: 100
                          minLength: 0
                        errorType:
                          type:
                          - string
                          - 'null'
                          enum:
                          - invalid
                          - duplicate
                          - missing
                          maxLength: 100
                          minLength: 0
                        errorMessage:
                          type:
                          - string
                          - 'null'
                          maxLength: 100
                          minLength: 0
                      required:
                      - errorMessage
                      - errorType
                      - fieldName
                    uniqueItems: false
                required:
                - errors
            - type:
              - 'null'
              - object
              additionalProperties: false
              properties:
                errorCode:
                  type:
                  - string
                  - 'null'
                  enum:
                  - URL_NOT_FOUND
                  - UNAUTHORIZED
                  - INVALID_OAUTH
                  - SCOPE_MISMATCH
                  - FORBIDDEN
                  - LICENSE_ACCESS_LIMITED
                  - METHOD_NOT_ALLOWED
                  - RESOURCE_SIZE_EXCEEDED
                  - UNSUPPORTED_MEDIA_TYPE
                  - INVALID_DATA
                  - UNPROCESSABLE_ENTITY
                  - ONLY_LIVECHAT_USER
                  - INTEGRATION_ADMIN_ERROR
                  - THRESHOLD_EXCEEDED
                  - INTERNAL_SERVER_ERROR
                  - EMPTY_PAYLOAD
                  maxLength: 100
                  minLength: 0
                message:
                  type:
                  - string
                  - 'null'
                  maxLength: 255
                  minLength: 0
              required:
              - errorCode
              - message
            - type:
              - 'null'
              - object
              additionalProperties: false
              properties:
                errorCode:
                  type:
                  - string
                  - 'null'
                  enum:
                  - URL_NOT_FOUND
                  - UNAUTHORIZED
                  - INVALID_OAUTH
                  - SCOPE_MISMATCH
                  - FORBIDDEN
                  - LICENSE_ACCESS_LIMITED
                  - METHOD_NOT_ALLOWED
                  - RESOURCE_SIZE_EXCEEDED
                  - UNSUPPORTED_MEDIA_TYPE
                  - INVALID_DATA
                  - UNPROCESSABLE_ENTITY
                  - ONLY_LIVECHAT_USER
                  - INTEGRATION_ADMIN_ERROR
                  - THRESHOLD_EXCEEDED
                  - INTERNAL_SERVER_ERROR
                  - EMPTY_PAYLOAD
                  maxLength: 100
                  minLength: 0
                message:
                  type:
                  - string
                  - 'null'
                  maxLength: 255
                  minLength: 0
              required:
              - errorCode
              - message
          examples:
            Valid responses Definitions:
              value:
                results:
                - success: true
                  id: '1892000000093303'
                  errors: null
                - success: true
                  id: '1892000000085009'
                  errors: null
                - success: false
                  id: '1892000000050003'
                  errors:
                    errorCode: UNPROCESSABLE_ENTITY
                    httpCode: '422'
    accountListArray:
      description: accountListArray template definitions
      content:
        application/json:
          schema:
            type:
            - 'null'
            - object
            additionalProperties: false
            properties:
              data:
                $ref: ./Account.json#/components/schemas/data
            required:
            - data
          examples:
            Valid responses Definitions:
              value:
                data:
                - website: '112121'
                  accountName: Admin Account
                  phone: '121212'
                  webUrl: https://desk.zoho.com/support/zylker/ShowHomePage.do#Accounts/dv/d126330fb061247d9ebddaeb9d93ba74750b0284bc703b38
                  createdTime: 1424105864000
                  zohoCRMAccount:
                    id: '32754000000537001'
                  customerHappiness:
                    badPercentage: '30'
                    okPercentage: '30'
                    goodPercentage: '40'
                  id: '1892000000052077'
                  email: admin@zylker.com
                - website: '1211212'
                  accountName: Agent Account
                  phone: '11211'
                  webUrl: https://desk.zoho.com/support/zylker/ShowHomePage.do#Accounts/dv/d126330fb061247d9ebddaeb9d93ba74750b0284bc703b38
                  createdTime: 1424105864000
                  zohoCRMAccount:
                    id: '32754000000537001'
                  customerHappiness:
                    badPercentage: '20'
                    okPercentage: '40'
                    goodPercentage: '40'
                  id: '1892000000052090'
                  email: agent@zylker.com
    accountListWithMappingInfoArray:
      description: accountListWithMappingInfoArray template definitions
      content:
        application/json:
          schema:
            type:
            - 'null'
            - object
            additionalProperties: false
            properties:
              data:
                $ref: ./Account.json#/components/schemas/dataWitMappingInfo
            required:
            - data
          examples:
            Valid responses Definitions:
              value:
                data:
                - website: www.zoho.com
                  accountName: ZOHO
                  phone: '8822120911'
                  mappingInfo:
                    mappingId: 1892000000052072
                    mappingType: PRIMARY
                    isAccountTicketsViewable: true
                  webUrl: https://desk.zoho.com/support/zylker/ShowHomePage.do#Accounts/dv/d126330fb061247d9ebddaeb9d93ba74750b0284bc703b38
                  createdTime: 1424105864000
                  zohoCRMAccount:
                    id: '32754000000537001'
                  customerHappiness:
                    badPercentage: '30'
                    okPercentage: '30'
                    goodPercentage: '40'
                  id: '1892000000052077'
                  email: admin@zylker.com
    getTicketsByAccountResponse:
      description: getTicketsByAccountResponse template definitions
      content:
        application/json:
          schema:
            allOf:
            - type: object
              proper

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