Skip to main content
Connectors

Zoho Desk connector

Set up the Zoho Desk connector in Kaivo: authentication, configuration, the 35 BigQuery tables it syncs, and answers to common questions.

Written By Lauri Raivio

Last updated 16 days ago

Kaivo is a fully managed data platform that syncs your Zoho Desk data into a Google BigQuery warehouse and keeps it up to date automatically. There is no pipeline to build and no infrastructure to run, so you can spend your time analysing your customer support data instead of moving it.

What is the Zoho Desk connector

Sync your Zoho Desk support data into BigQuery with Kaivo to measure ticket volume, response times, and team performance.

CategoryCustomer Service
AuthenticationAPI key
SetupSelf-service

Getting started with the Zoho Desk connector

  1. Sign up for Kaivo and create a workspace.
  2. Connect your Zoho Desk account.
  3. Choose which tables to sync.
  4. Wait for the initial sync to finish.
  5. Query your data in BigQuery or your favourite AI or BI tool.

Authenticating Zoho Desk

Authenticate with your Zoho Desk credentials. You provide:

FieldDescription
Client Secret

The Client Secret of your Zoho Desk developer application.

OAuth Refresh Token

The refresh token obtained after completing the Zoho OAuth authorization flow.

Prerequisites

Zoho Desk only supports OAuth, so you need your own Zoho developer application:

  1. Go to the Zoho API Console, create a Self Client (or a Server-based Application), and note your Client ID and Client Secret.
  2. Generate a grant token with the required Zoho Desk API scopes, then exchange it for a Refresh Token (see Zoho Desk OAuth docs). Use the accounts URL for your account's region (e.g. accounts.zoho.eu for the EU).
  3. Select your Data Center below — the suffix of your Zoho Desk URL (com, eu, in, com.au, com.cn, jp, or ca). Using the wrong region returns authorization errors even with a valid token.

Then enter those values below.

Need help, or want an easier way to connect? Reach our team via the chat in the bottom-right corner.

Configuring the Zoho Desk connector

When you set up the connector, you provide:

FieldDescription
Client ID

The Client ID of your Zoho Desk developer application.

Data Center

The Zoho data center where your Zoho Desk account is hosted (the suffix of your desk.zoho.<...> URL).

Tables and columns synced from Zoho Desk

Kaivo syncs 35 tables from Zoho Desk into a dedicated dataset in your BigQuery warehouse. Click any table to see its columns and types.

ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
citySTRING
company_nameSTRING
countrySTRING
currency_codeSTRING
currency_localeSTRING
currency_symbolSTRING
editionSTRING
employee_countFLOAT64
favicon_urlSTRING
faxSTRING
idFLOAT64
is_admin_in_orgBOOL
is_defaultBOOL
is_payload_encryption_enabledBOOL
is_sandbox_portalBOOL
logo_urlSTRING
mobileSTRING
phone_numberSTRING
portal_nameSTRING
portal_urlSTRING
primary_contactSTRING
stateSTRING
streetSTRING
websiteSTRING
zipSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
about_infoSTRING
country_codeSTRING
email_idSTRING
extnSTRING
first_nameSTRING
idSTRING
is_confirmedBOOL
lang_codeSTRING
last_nameSTRING
mobileSTRING
nameSTRING
phoneSTRING
photo_urlSTRING
profile_idSTRING
role_idSTRING
role_permission_typeSTRING
statusSTRING
time_zoneSTRING
zuidSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: agent__associated_chat_department_ids

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
valueJSON
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: agent__associated_department_ids

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
valueSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: agent__channel_expert

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
valueJSON
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
about_infoSTRING
email_idSTRING
extnSTRING
first_nameSTRING
idSTRING
is_confirmedBOOL
last_nameSTRING
mobileSTRING
phoneSTRING
photo_urlSTRING
profile_idSTRING
role_idSTRING
role_permission_typeSTRING
statusSTRING
zuidSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: agent_details_by_id__associated_department_ids

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
valueJSON
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: agent_details_by_id__channel_expert

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
valueJSON
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
citySTRING
company_nameSTRING
countrySTRING
currency_codeSTRING
currency_localeSTRING
currency_symbolSTRING
editionSTRING
employee_countFLOAT64
favicon_urlSTRING
faxSTRING
idFLOAT64
is_admin_in_orgBOOL
is_defaultBOOL
is_payload_encryption_enabledBOOL
is_sandbox_portalBOOL
logo_urlSTRING
mobileSTRING
phone_numberSTRING
portal_nameSTRING
portal_urlSTRING
primary_contactSTRING
stateSTRING
streetSTRING
websiteSTRING
zipSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
descriptionSTRING
activity_timeSTRING
completed_timeSTRING
contact_idSTRING
created_timeSTRING
creator_idSTRING
department_idSTRING
directionSTRING
durationSTRING
idSTRING
is_spamBOOL
is_trashedBOOL
layout_idSTRING
modified_by__email_idSTRING
modified_by__first_nameSTRING
modified_by__idSTRING
modified_by__last_nameSTRING
modified_by__photo_urlSTRING
modified_timeSTRING
owner_idSTRING
prioritySTRING
start_timeSTRING
statusSTRING
status_typeSTRING
subjectSTRING
ticket_idSTRING
web_urlSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
typeSTRING
accepts_repliesBOOL
codeSTRING
nameSTRING
reply_config__accepts_attachmentsBOOL
reply_config__include_quoted_messageBOOL
reply_config__update_recordsBOOL
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: channels__reply_config__content_types

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
valueSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
avgSTRING
grouped_bySTRING
total_ticket_countSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: dashboard_created_tickets__ticket_count

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
countSTRING
valueSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
countSTRING
valueSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
attachment_countSTRING
author__typeSTRING
author__emailSTRING
author__first_nameSTRING
author__idSTRING
author__last_nameSTRING
author__nameSTRING
author__photo_urlSTRING
bccSTRING
can_replyBOOL
ccSTRING
channelSTRING
contentSTRING
content_typeSTRING
created_timeSTRING
directionSTRING
from_email_addressSTRING
has_attachBOOL
idSTRING
is_content_truncatedBOOL
is_description_threadBOOL
is_forwardBOOL
reply_toSTRING
responder_idSTRING
source__typeSTRING
statusSTRING
summarySTRING
toSTRING
visibilitySTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: get_latest_thread__actions

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
valueJSON
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: get_latest_thread__attachments

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
valueJSON
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
account_nameSTRING
created_timeSTRING
customer_happiness__bad_percentageSTRING
customer_happiness__good_percentageSTRING
customer_happiness__ok_percentageSTRING
emailSTRING
idSTRING
phoneSTRING
web_urlSTRING
websiteSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
about_infoSTRING
country_codeSTRING
email_idSTRING
extnSTRING
first_nameSTRING
idSTRING
is_confirmedBOOL
lang_codeSTRING
last_nameSTRING
mobileSTRING
nameSTRING
phoneSTRING
photo_urlSTRING
profile_idSTRING
role_idSTRING
role_permission_typeSTRING
statusSTRING
time_zoneSTRING
zuidSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: list_agents__associated_chat_department_ids

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
valueJSON
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: list_agents__associated_department_ids

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
valueSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: list_agents__channel_expert

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
valueJSON
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
attachment_countSTRING
author__typeSTRING
author__emailSTRING
author__first_nameSTRING
author__idSTRING
author__last_nameSTRING
author__nameSTRING
author__photo_urlSTRING
bccSTRING
can_replyBOOL
ccSTRING
channelSTRING
content_typeSTRING
created_timeSTRING
directionSTRING
from_email_addressSTRING
has_attachBOOL
idSTRING
is_description_threadBOOL
is_forwardBOOL
responded_inSTRING
responder_idSTRING
source__typeSTRING
statusSTRING
summarySTRING
toSTRING
visibilitySTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: list_all_threads__actions

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
valueJSON
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
attachment_countSTRING
author__idSTRING
author__nameSTRING
author__photo_urlSTRING
author__statusSTRING
author__zuidSTRING
author_idSTRING
category__idSTRING
category__localeSTRING
category__nameSTRING
category_idSTRING
comment_countSTRING
created_by__idSTRING
created_by__nameSTRING
created_by__photo_urlSTRING
created_by__statusSTRING
created_by__zuidSTRING
created_timeSTRING
creator_idSTRING
department_idSTRING
dislike_countSTRING
feedback_countSTRING
idSTRING
is_lockedBOOL
is_trashedBOOL
latest_published_versionSTRING
latest_versionSTRING
latest_version_modified_by__idSTRING
latest_version_modified_by__nameSTRING
latest_version_modified_by__photo_urlSTRING
latest_version_modified_by__statusSTRING
latest_version_modified_by__zuidSTRING
latest_version_modifier_idSTRING
latest_version_statusSTRING
like_countSTRING
localeSTRING
modified_by__idSTRING
modified_by__nameSTRING
modified_by__photo_urlSTRING
modified_by__statusSTRING
modified_by__zuidSTRING
modified_timeSTRING
modifier_idSTRING
owner__idSTRING
owner__nameSTRING
owner__photo_urlSTRING
owner__statusSTRING
owner__zuidSTRING
owner_idSTRING
permalinkSTRING
permissionSTRING
portal_urlSTRING
positionSTRING
root_category_idSTRING
source_localeSTRING
statusSTRING
summarySTRING
titleSTRING
translation_idSTRING
translation_stateSTRING
usage_countSTRING
view_countSTRING
web_urlSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: list_articles__available_locale_translations

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
author_idSTRING
hrefSTRING
is_lockedBOOL
is_trashedBOOL
latest_published_versionSTRING
latest_versionSTRING
latest_version_statusSTRING
localeSTRING
statusSTRING
translation_idSTRING
translation_stateSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: list_attachments__data

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
created_timeSTRING
creator_idSTRING
hrefSTRING
idSTRING
nameSTRING
sizeSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
commented_timeSTRING
commenter__typeSTRING
commenter__emailSTRING
commenter__first_nameSTRING
commenter__idSTRING
commenter__last_nameSTRING
commenter__nameSTRING
commenter__photo_urlSTRING
commenter__role_nameSTRING
commenter_idSTRING
contentSTRING
content_typeSTRING
encoded_contentSTRING
idSTRING
modified_timeSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: list_call_comments__attachments

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
valueJSON
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
activity_timeSTRING
completed_timeSTRING
contact_idSTRING
created_timeSTRING
creator_idSTRING
department_idSTRING
directionSTRING
idSTRING
is_commentedBOOL
is_spamBOOL
is_trashedBOOL
layout_idSTRING
modified_by__email_idSTRING
modified_by__first_nameSTRING
modified_by__idSTRING
modified_by__last_nameSTRING
modified_by__photo_urlSTRING
modified_timeSTRING
owner_idSTRING
prioritySTRING
start_timeSTRING
statusSTRING
status_typeSTRING
subjectSTRING
ticket_idSTRING
web_urlSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
account_countSTRING
account_idSTRING
created_timeSTRING
customer_happiness__bad_percentageSTRING
customer_happiness__good_percentageSTRING
customer_happiness__ok_percentageSTRING
emailSTRING
first_nameSTRING
idSTRING
is_anonymousBOOL
is_end_userBOOL
is_spamBOOL
last_nameSTRING
mobileSTRING
owner_idSTRING
phoneSTRING
web_urlSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
account_idSTRING
associated_sla_idSTRING
contract_nameSTRING
contract_statusSTRING
department_idSTRING
idSTRING
sla_nameSTRING
start_dateSTRING
support_plan__idSTRING
support_plan__nameSTRING
support_plan__statusSTRING
support_plan__support_typeSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: list_departments__data

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
chat_statusSTRING
created_timeSTRING
creator_idSTRING
has_logoBOOL
idSTRING
is_assign_to_team_enabledBOOL
is_defaultBOOL
is_enabledBOOL
is_visible_in_customer_portalBOOL
nameSTRING
name_in_customer_portalSTRING
sanitized_nameSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
activity_timeSTRING
categorySTRING
contact_idSTRING
created_timeSTRING
creator_idSTRING
department_idSTRING
idSTRING
is_commentedBOOL
is_spamBOOL
is_trashedBOOL
layout_idSTRING
modified_by__email_idSTRING
modified_by__first_nameSTRING
modified_by__idSTRING
modified_by__last_nameSTRING
modified_by__photo_urlSTRING
modified_timeSTRING
owner_idSTRING
prioritySTRING
start_timeSTRING
statusSTRING
status_typeSTRING
subjectSTRING
web_urlSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
idSTRING
product_codeSTRING
product_nameSTRING
unit_priceSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
descriptionSTRING
idSTRING
is_defaultBOOL
is_visibleBOOL
nameSTRING
reports_toSTRING
share_data_with_peersBOOL
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: list_roles__immediate_sub_roles

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
valueSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
activity_timeSTRING
contact_idSTRING
created_timeSTRING
creator_idSTRING
department_idSTRING
due_dateSTRING
idSTRING
is_commentedBOOL
is_spamBOOL
is_trashedBOOL
layout_idSTRING
modified_by__email_idSTRING
modified_by__first_nameSTRING
modified_by__idSTRING
modified_by__last_nameSTRING
modified_by__photo_urlSTRING
modified_timeSTRING
owner_idSTRING
prioritySTRING
statusSTRING
status_typeSTRING
subjectSTRING
ticket_idSTRING
web_urlSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
assignee_idSTRING
channelSTRING
comment_countSTRING
contact_idSTRING
created_timeSTRING
customer_response_timeSTRING
department_idSTRING
due_dateSTRING
emailSTRING
idSTRING
is_archivedBOOL
is_spamBOOL
languageSTRING
last_thread__channelSTRING
last_thread__directionSTRING
last_thread__is_draftBOOL
last_thread__is_forwardBOOL
layout_idSTRING
phoneSTRING
product_idSTRING
source__typeSTRING
statusSTRING
status_typeSTRING
subjectSTRING
thread_countSTRING
ticket_numberSTRING
web_urlSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
added_timeSTRING
help_center_idSTRING
idSTRING
logo_urlSTRING
nameSTRING
statusSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
email_addressSTRING
idSTRING
last_accessed_timeSTRING
nameSTRING
statusSTRING
user_typeSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
api_nameSTRING
created_timeSTRING
display_labelSTRING
has_recycle_binBOOL
idSTRING
is_custom_moduleBOOL
is_dept_specificBOOL
modified_timeSTRING
name_fieldSTRING
plural_labelSTRING
singular_labelSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
citySTRING
company_nameSTRING
countrySTRING
currency_codeSTRING
currency_localeSTRING
currency_symbolSTRING
editionSTRING
employee_countFLOAT64
favicon_urlSTRING
faxSTRING
idFLOAT64
is_admin_in_orgBOOL
is_defaultBOOL
is_payload_encryption_enabledBOOL
is_sandbox_portalBOOL
logo_urlSTRING
mobileSTRING
phone_numberSTRING
portal_nameSTRING
portal_urlSTRING
primary_contactSTRING
stateSTRING
streetSTRING
websiteSTRING
zipSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
created_bySTRING
created_timeSTRING
idSTRING
is_deletedBOOL
layout_details__idSTRING
layout_details__layout_nameSTRING
layout_idSTRING
modified_bySTRING
modified_timeSTRING
owner_idSTRING
product_categorySTRING
product_codeSTRING
product_nameSTRING
unit_priceSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: product__department_ids

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
valueSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
typeSTRING
descriptionSTRING
defaultBOOL
idSTRING
is_visibleBOOL
nameSTRING
permissions__community_comment__viewBOOL
permissions__community_topic__viewBOOL
permissions__accounts__createBOOL
permissions__accounts__deleteBOOL
permissions__accounts__editBOOL
permissions__accounts__exportBOOL
permissions__accounts__importBOOL
permissions__accounts__viewBOOL
permissions__agents__createBOOL
permissions__agents__deleteBOOL
permissions__agents__editBOOL
permissions__agents__importBOOL
permissions__agents__overviewBOOL
permissions__agents__view_all_fieldsBOOL
permissions__calls__createBOOL
permissions__calls__deleteBOOL
permissions__calls__editBOOL
permissions__calls__exportBOOL
permissions__calls__importBOOL
permissions__calls__viewBOOL
permissions__chat__viewBOOL
permissions__comments__deleteBOOL
permissions__comments__editBOOL
permissions__community__createBOOL
permissions__community__deleteBOOL
permissions__community__editBOOL
permissions__community__moderateBOOL
permissions__community__viewBOOL
permissions__contacts__createBOOL
permissions__contacts__deleteBOOL
permissions__contacts__editBOOL
permissions__contacts__exportBOOL
permissions__contacts__importBOOL
permissions__contacts__viewBOOL
permissions__contracts__createBOOL
permissions__contracts__deleteBOOL
permissions__contracts__editBOOL
permissions__contracts__exportBOOL
permissions__contracts__importBOOL
permissions__contracts__viewBOOL
permissions__crm_integ__crm_accounts_activity_callsBOOL
permissions__crm_integ__crm_accounts_activity_eventsBOOL
permissions__crm_integ__crm_accounts_activity_tasksBOOL
permissions__crm_integ__crm_accounts_infoBOOL
permissions__crm_integ__crm_accounts_notesBOOL
permissions__crm_integ__crm_accounts_potentialsBOOL
permissions__crm_integ__crm_contacts_activity_callsBOOL
permissions__crm_integ__crm_contacts_activity_eventsBOOL
permissions__crm_integ__crm_contacts_activity_tasksBOOL
permissions__crm_integ__crm_contacts_infoBOOL
permissions__crm_integ__crm_contacts_notesBOOL
permissions__crm_integ__crm_contacts_potentialsBOOL
permissions__events__createBOOL
permissions__events__deleteBOOL
permissions__events__editBOOL
permissions__events__exportBOOL
permissions__events__importBOOL
permissions__events__viewBOOL
permissions__finance_integ__create_contactBOOL
permissions__finance_integ__create_estimateBOOL
permissions__finance_integ__create_invoiceBOOL
permissions__finance_integ__create_sales_orderBOOL
permissions__finance_integ__send_estimateBOOL
permissions__finance_integ__send_invoiceBOOL
permissions__finance_integ__send_sales_orderBOOL
permissions__finance_integ__view_estimateBOOL
permissions__finance_integ__view_invoiceBOOL
permissions__finance_integ__view_sales_orderBOOL
permissions__finance_integ__view_subscriptionBOOL
permissions__gc__createBOOL
permissions__gc__deleteBOOL
permissions__gc__editBOOL
permissions__gc__viewBOOL
permissions__im__createBOOL
permissions__im__deleteBOOL
permissions__im__editBOOL
permissions__im__viewBOOL
permissions__kb_category__adminBOOL
permissions__kb_category__createBOOL
permissions__kb_category__deleteBOOL
permissions__kb_category__editBOOL
permissions__kb_category__edit_all_articlesBOOL
permissions__kb_category__exportBOOL
permissions__kb_category__importBOOL
permissions__kb_category__manage_kbBOOL
permissions__kb_category__viewBOOL
permissions__mobileapp__deskappBOOL
permissions__mobileapp__radarBOOL
permissions__products__createBOOL
permissions__products__deleteBOOL
permissions__products__editBOOL
permissions__products__exportBOOL
permissions__products__importBOOL
permissions__products__viewBOOL
permissions__reports__createBOOL
permissions__reports__deleteBOOL
permissions__reports__editBOOL
permissions__reports__exportBOOL
permissions__reports__viewBOOL
permissions__setup__automationBOOL
permissions__setup__buttonsBOOL
permissions__setup__chatBOOL
permissions__setup__communityBOOL
permissions__setup__customer_happinessBOOL
permissions__setup__departmentBOOL
permissions__setup__emailBOOL
permissions__setup__export_portal_usersBOOL
permissions__setup__export_usersBOOL
permissions__setup__feature_configBOOL
permissions__setup__gamificationBOOL
permissions__setup__google_analyticsBOOL
permissions__setup__imBOOL
permissions__setup__import_historyBOOL
permissions__setup__layoutsBOOL
permissions__setup__localizationBOOL
permissions__setup__manage_agentsBOOL
permissions__setup__manage_marketplaceBOOL
permissions__setup__manager_dashboardBOOL
permissions__setup__mass_replyBOOL
permissions__setup__permissionBOOL
permissions__setup__pinned_conversationsBOOL
permissions__setup__portalBOOL
permissions__setup__portal_usersBOOL
permissions__setup__privacy_settingsBOOL
permissions__setup__rebrandingBOOL
permissions__setup__recycle_binBOOL
permissions__setup__sandboxBOOL
permissions__setup__security_settingsBOOL
permissions__setup__share_snippetBOOL
permissions__setup__sign_up_approvalBOOL
permissions__setup__socialBOOL
permissions__setup__tabs_and_fieldsBOOL
permissions__setup__teamsBOOL
permissions__setup__telephonyBOOL
permissions__setup__templatesBOOL
permissions__setup__time_trackingBOOL
permissions__setup__web_formBOOL
permissions__setup__webhooksBOOL
permissions__social__twitter_conversation_replyBOOL
permissions__social__twitter_post_createBOOL
permissions__social__twitter_post_deleteBOOL
permissions__social__viewBOOL
permissions__tasks__createBOOL
permissions__tasks__deleteBOOL
permissions__tasks__editBOOL
permissions__tasks__exportBOOL
permissions__tasks__importBOOL
permissions__tasks__viewBOOL
permissions__tickets__add_followersBOOL
permissions__tickets__change_ownerBOOL
permissions__tickets__close_ticketBOOL
permissions__tickets__createBOOL
permissions__tickets__deleteBOOL
permissions__tickets__delete_tagsBOOL
permissions__tickets__editBOOL
permissions__tickets__edit_tagsBOOL
permissions__tickets__exportBOOL
permissions__tickets__handle_unassignedBOOL
permissions__tickets__importBOOL
permissions__tickets__mail_reviewBOOL
permissions__tickets__mail_sendBOOL
permissions__tickets__merge_ticketsBOOL
permissions__tickets__revoke_blueprintBOOL
permissions__tickets__unassigned_change_ownerBOOL
permissions__tickets__viewBOOL
permissions__time_entry__createBOOL
permissions__time_entry__deleteBOOL
permissions__time_entry__editBOOL
permissions__time_entry__viewBOOL
permissions__zia__createBOOL
permissions__zia__deleteBOOL
permissions__zia__editBOOL
permissions__zia__viewBOOL
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
created_timeSTRING
creator_idSTRING
hrefSTRING
idSTRING
nameSTRING
sizeSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
email_idSTRING
first_nameSTRING
idSTRING
last_nameSTRING
photo_urlSTRING
profile_idSTRING
role_idSTRING
zuidSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
descriptionSTRING
department_idSTRING
idSTRING
nameSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: teams__agents

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
valueSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: teams__derived_agents

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
valueSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: teams__roles

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
valueJSON
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: teams__roles_with_subordinates

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
valueJSON
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: teams__sub_teams

ColumnTypeDescription
_kaivo_parent_idSTRINGForeign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
valueJSON
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
activity_timeSTRING
activity_typeSTRING
completed_timeSTRING
contact_idSTRING
created_timeSTRING
creator_idSTRING
department_idSTRING
directionSTRING
due_dateSTRING
idSTRING
is_commentedBOOL
is_spamBOOL
is_trashedBOOL
layout_idSTRING
modified_by__email_idSTRING
modified_by__first_nameSTRING
modified_by__idSTRING
modified_by__last_nameSTRING
modified_by__photo_urlSTRING
modified_timeSTRING
owner_idSTRING
prioritySTRING
start_timeSTRING
statusSTRING
status_typeSTRING
subjectSTRING
ticket_idSTRING
web_urlSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.
ColumnTypeDescription
_kaivo_idSTRINGPrimary key that uniquely identifies the row. Auto-generated by Kaivo.
typeSTRING
descriptionSTRING
created_bySTRING
created_timeSTRING
idSTRING
ignore_source_idSTRING
is_enabledBOOL
modified_timeSTRING
nameSTRING
urlSTRING
_kaivo_extracted_atTIMESTAMPTimestamp that shows when the row was extracted. Auto-generated by Kaivo.

How the Zoho Desk sync works

After the first load, Kaivo keeps your BigQuery warehouse up to date for you. Where Zoho Desk supports it, each sync pulls only new and changed records so it stays fast; otherwise it refreshes the whole table. Every record keeps its original ID, so you won't get duplicate rows.

Frequently asked questions

How long does the initial sync take for Zoho Desk?

It depends on how much history is in your Zoho Desk account. Most initial syncs finish within minutes, while large accounts can take a few hours. After that, syncs only fetch new and changed records, so they're much faster.

Can I sync only some tables or columns?

Yes. You pick which tables to sync when you set up the connection and can change the selection later. Tables you don't select are never copied to your warehouse.

What happens when Zoho Desk's schema changes?

New fields are never added automatically. You choose which fields to sync, so data you haven't selected (sensitive personal data, for example) never lands in your warehouse. When a new field appears, it becomes available for you to add. What happens to removed or renamed fields depends on a table's sync mode: full-refresh tables always match what's currently in Zoho Desk, so dropped fields disappear, while incremental tables keep their existing columns and history, so an old field stays and newly added fields fill in over time.

How do I handle GDPR or data deletion requests?

Your data lives in your own Kaivo-managed BigQuery warehouse, so the most direct option is to delete or anonymise specific records right in BigQuery. If you delete data in Zoho Desk instead, full-refresh tables drop it on the next sync, while incremental tables keep it, so you would remove the row in BigQuery or ask us to run a full refresh. To remove everything, delete the Zoho Desk connector in Kaivo and all of its synced data is deleted with it.

Common use cases for Zoho Desk data

Ticket volume

Use list_tickets and list_all_threads to track support volume over time.

Team performance

Join list_agents with teams to compare workload and handling.

Department view

Use list_departments and channels to see where support load sits.

Use Zoho Desk data in your AI and BI tools

Once Zoho Desk data lands in your Kaivo-managed BigQuery warehouse, you can explore it with AI tools or any BI tool that connects to BigQuery. Here's how the most common destinations work with Zoho Desk data.

Claude

Use Kaivo's MCP server to give Claude secure, workspace-scoped access to your data. Setup guide →

Power BI

Microsoft's BI tool with a native BigQuery connector. Supports direct query and scheduled refresh. Setup guide →

Data Studio

Free Google BI tool with native BigQuery support. One-click connection to your Kaivo warehouse; great for SMB teams on Google Workspace. Setup guide →

Tableau

The premium analytics standard, with native BigQuery integration. Setup guide →

Google Sheets

Use Connected Sheets to query BigQuery directly from a spreadsheet, with no SQL. Setup guide →

Excel

Connect via Power Query's BigQuery connector. Setup guide →

Metabase

Open-source BI tool with strong BigQuery support. Setup guide →

See our pricing page for Zoho Desk connector pricing and plan details.

Was this helpful?

Still need help? Share an idea