Creating the data source
Requirements
- Follow the steps using an Owner/Administrator account
- If your Zendesk account has IP blocking enabled, also allow Kondado’s IPs
Instructions
- Log in to your Zendesk account with an Owner/Administrator account
- Once inside, select the gear icon (settings) on the left sidebar, then go to Channels > API
- In APIs, enable token access and then click on Add New
- On the new token edit page, give it a name (for example, Kondado integration), copy the generated value, and click Save
- In the Kondado platform, click CREATE+ > Connector > and select the Zendesk connector
- Fill in the information as follows

- Name: The name of your integration, for example, “Zendesk”
- Email (Owner): The email of the Zendesk account Owner
- Token: The token generated in step 4
- Subdomain: Your Zendesk subdomain. For example, if your Zendesk URL is company.zendesk.com, then your subdomain is company
If your Zendesk account has IP blocking enabled, also allow Kondado’s IPs
Pipelines
Summary
Relationship chart
Click to expand
Brands
Replication type: Full
Main object
| Campo | Tipo | |
|---|---|---|
|
text |
[en] The unique identifier of the brand in Zendesk. |
|
|
boolean |
[en] Specifies whether the brand is currently active in Zendesk. |
|
|
text |
[en] The public URL for the brand, typically used by customers to access the help center or support site. |
|
|
boolean |
[en] Indicates if this brand is set as the default brand for the Zendesk account. |
|
|
boolean |
[en] Indicates whether the brand has an active Help Center enabled. |
|
|
text |
[en] The current state of the brand's Help Center (e.g., enabled, disabled). |
|
|
text |
[en] The custom host mapping (CNAME) used to map the brand’s support site to a custom domain. |
|
|
boolean |
[en] Specifies whether the brand has been deleted from Zendesk. |
|
|
text |
[en] The MIME type of the logo file (e.g., image/png). |
|
|
text |
[en] The direct URL where the logo image can be accessed. |
|
|
boolean |
[en] Specifies whether the logo file has been deleted. |
|
|
text |
[en] The file name of the logo image. |
|
|
float |
[en] The height of the logo image in pixels. |
|
|
text |
[en] The unique identifier of the logo attachment. |
|
|
boolean |
[en] Indicates whether the logo is intended for inline display. |
|
|
text |
[en] The mapped URL of the logo image, typically the same as content_url. |
|
|
float |
[en] The file size of the logo image in bytes. |
|
|
text |
[en] The API endpoint URL for retrieving the brand's logo attachment details. |
|
|
float |
[en] The width of the logo image in pixels. |
|
|
text |
[en] The name of the brand (e.g., Torra). |
|
|
text |
[en] The Zendesk subdomain associated with the brand. |
|
|
text |
[en] The API endpoint URL for retrieving the brand details in Zendesk. |
|
|
text |
||
|
text |
||
|
timestamp |
||
|
timestamp |
zendesk_brands_logo_thumbnails
| Campo | Tipo | |
|---|---|---|
|
text |
[en] The unique identifier of the brand in Zendesk. |
|
|
text |
[en] The unique identifier of the logo thumbnail attachment. |
|
|
text |
[en] The MIME type of the thumbnail file (e.g., image/png). |
|
|
text |
[en] The direct URL where the thumbnail image can be accessed. |
|
|
boolean |
[en] Specifies whether the thumbnail file has been deleted. |
|
|
text |
[en] The file name of the thumbnail image. |
|
|
float |
[en] The height of the thumbnail image in pixels. |
|
|
boolean |
[en] Indicates whether the thumbnail is intended for inline display. |
|
|
text |
[en] The mapped URL of the thumbnail image, typically the same as content_url. |
|
|
float |
[en] The file size of the thumbnail image in bytes. |
|
|
text |
[en] The API endpoint URL for retrieving a thumbnail version of the logo. |
|
|
float |
[en] The width of the thumbnail image in pixels. |
Closed and Deleted Tickets
Replication type: Incremental
Deleted Zendesk tickets with actor, status, and timestamps.
| Campo | Tipo | |
|---|---|---|
|
text |
[en] Unique identifier of the ticket. |
|
|
text |
[en] Identifier of the actor (agente ou usuário) que realizou a exclusão. |
|
|
text |
[en] Display name of the actor who deleted the ticket. |
|
|
timestamp |
[en] Date and time when the ticket was deleted. |
|
|
text |
[en] Main description/content of the deleted ticket. |
|
|
text |
[en] Status of the ticket before deletion (ex.: solved, closed). |
|
|
text |
[en] Subject/title of the deleted ticket. |
Groups
Replication type: Full
Zendesk groups with membership and status information.
| Campo | Tipo | |
|---|---|---|
|
text |
[en] Unique identifier of the group. |
|
|
timestamp |
[en] When the group was last updated. |
|
|
boolean |
[en] Indicates whether this is the account’s default group. |
|
|
text |
[en] Group name. |
|
|
text |
[en] URL for the group record. |
|
|
timestamp |
[en] When the group was created. |
|
|
boolean |
[en] Flags whether the group is marked as deleted. |
|
|
text |
[en] Text description of the group. |
Jira links
Replication type: Full
Links between Zendesk tickets and Jira issues.
| Campo | Tipo | |
|---|---|---|
|
text |
[en] Identifier of the link record. |
|
|
text |
[en] ID of the related Zendesk ticket. |
|
|
text |
[en] ID da issue correspondente no Jira. |
|
|
text |
[en] Key of the linked Jira issue. |
|
|
text |
[en] URL for the link record. |
|
|
timestamp |
[en] When the link was created. |
|
|
timestamp |
[en] When the link was last updated. |
Organizations
Replication type: Full
Zendesk organizations with domains, sharing settings, custom fields and timestamps.
| Campo | Tipo | |
|---|---|---|
|
text |
[en] Unique identifier of the organization. |
|
|
boolean |
[en] Allows end users in the organization to see each other’s ticket comments. |
|
|
timestamp |
[en] When the organization was last updated. |
|
|
text |
[en] Email domains linked to the organization. |
|
|
boolean |
[en] Allows end users in the organization to view each other’s tickets. |
|
|
text |
[en] Unique name of the organization. |
|
|
text |
[en] URL for the organization record. |
|
|
text |
[en] Custom fields stored for the organization. |
|
|
timestamp |
[en] When the organization was created. |
|
|
text |
[en] Tags associated with the organization. |
|
|
text |
[en] Additional details about the organization (e.g., address). |
|
|
text |
[en] Group automatically assigned to new tickets from this organization. |
|
|
text |
[en] External ID to link the organization to another system (case-insensitive). |
|
|
text |
[en] Internal notes about the organization. |
Satisfaction ratings
Replication type: Incremental
Satisfaction ratings for tickets, with requester, assignee and timestamps.
| Campo | Tipo | |
|---|---|---|
|
text |
[en] Unique identifier of the satisfaction rating. |
|
|
text |
[en] Comment submitted with the rating, when available. |
|
|
text |
[en] Agent assigned at the time of the rating. |
|
|
text |
[en] Rating value (offered, unoffered, good, bad). |
|
|
text |
[en] Identifier of the rated ticket. |
|
|
text |
[en] Requester who submitted the rating. |
|
|
text |
[en] URL for the rating record. |
|
|
timestamp |
[en] When the satisfaction rating was created. |
|
|
text |
[en] Group assigned to the ticket when rated. |
|
|
timestamp |
[en] When the satisfaction rating was last updated. |
Ticket Metric Events
Replication type: Incremental
Event history for ticket SLA metrics (apply, pause, breach, status updates).
| Campo | Tipo | |
|---|---|---|
|
text |
[en] Unique identifier of the metric event. |
|
|
boolean |
[en] Available for breach events; ignore when true. |
|
|
boolean |
[en] Indicates if group SLA timing uses business hours. |
|
|
text |
[en] Description of the group SLA policy applied. |
|
|
text |
[en] Title of the group SLA policy applied. |
|
|
text |
[en] For apply_group_sla events: ID of the enforced group SLA policy. |
|
|
float |
[en] Group SLA target being enforced (apply_group_sla events). |
|
|
text |
[en] Instance number of the metric event (increments per ticket). |
|
|
text |
[en] Metric tracked (ex.: agent_work_time, reply_time, requester_wait_time). |
|
|
boolean |
||
|
text |
[en] Description of the SLA policy applied. |
|
|
text |
[en] Title of the SLA policy applied. |
|
|
text |
[en] Available for apply_sla events: ID of the SLA policy enforced. |
|
|
float |
[en] SLA target being enforced (apply_sla events). |
|
|
float |
[en] For update_status events: minutes open in business hours. |
|
|
float |
[en] For update_status events: minutes open in calendar hours. |
|
|
text |
[en] Identifier of the associated ticket. |
|
|
timestamp |
[en] Timestamp when the event occurred. |
|
|
text |
[en] Type of metric event (activate, pause, fulfill, apply_sla, breach, update_status, measure). |
Ticket audits
Replication type: Incremental
Main object
Audits of ticket changes with channel metadata and author details.
| Campo | Tipo | |
|---|---|---|
|
text |
[en] Unique identifier of the audit event. |
|
|
text |
[en] Identifier of the ticket associated with the audit. |
|
|
text |
[en] Destination name captured in the channel metadata. |
|
|
text |
[en] Destination address captured in the channel metadata. |
|
|
text |
[en] Original recipients listed in the channel metadata. |
|
|
text |
[en] Source name captured in the channel metadata. |
|
|
text |
[en] Source address captured in the channel metadata. |
|
|
text |
[en] Relationship indicator in the source metadata. |
|
|
text |
[en] Channel through which the audit action happened. |
|
|
timestamp |
[en] When the audit event was created. |
|
|
text |
[en] User who generated the audit event. |
|
|
float |
[en] Latitude recorded in system metadata, when available. |
|
|
text |
[en] Client user agent recorded in system metadata. |
|
|
text |
[en] IP address recorded in system metadata. |
|
|
text |
[en] Location string derived from system metadata. |
|
|
float |
[en] Longitude recorded in system metadata, when available. |
zendesk_ticket_audits__events
Events that compose each ticket audit, including type and payload.
Ticket comments
Replication type: Incremental
Comments on tickets with author and creation details.
| Campo | Tipo | |
|---|---|---|
|
text |
[en] Identifier of the ticket the comment belongs to. |
|
|
text |
[en] Identifier of the comment. |
|
|
text |
[en] Identifier of the user who authored the comment. |
|
|
timestamp |
[en] When the comment was created. |
|
|
boolean |
[en] Indicates whether the comment is public. |
|
|
text |
[en] Body of the comment in text form. |
Ticket metrics
Replication type: Incremental
Zendesk Chat ticket metrics with waits, replies, and reopens.
| Campo | Tipo | |
|---|---|---|
|
text |
[en] Identifier of the associated ticket. |
|
|
text |
[en] Identifier of the ticket metric record. |
|
|
timestamp |
[en] When the metric record was last updated. |
|
|
timestamp |
[en] When the ticket was solved. |
|
|
int |
[en] Number of public replies added by agents. |
|
|
float |
[en] Minutes to full resolution (calendar hours). |
|
|
float |
[en] Minutes to full resolution (business hours). |
|
|
float |
[en] Minutes on hold during calendar hours. |
|
|
float |
[en] Minutes on hold during business hours. |
|
|
timestamp |
[en] When the ticket status was last updated. |
|
|
float |
[en] Number of different assignees the ticket had. |
|
|
timestamp |
[en] When the requester last updated the ticket. |
|
|
timestamp |
[en] When the ticket was first assigned. |
|
|
float |
[en] Number of groups the ticket passed through. |
|
|
float |
[en] Minutes to first resolution (calendar hours). |
|
|
float |
[en] Minutes to first resolution (business hours). |
|
|
timestamp |
[en] When the ticket was assigned. |
|
|
timestamp |
[en] When the latest comment was added. |
|
|
float |
[en] Minutes to first reply (calendar hours). |
|
|
float |
[en] Minutes to first reply (business hours). |
|
|
text |
[en] URL for the ticket metric record. |
|
|
timestamp |
[en] When the metric record was created. |
|
|
timestamp |
[en] When the assignee last updated the ticket. |
|
|
float |
[en] Number of times the ticket was reopened. |
|
|
float |
[en] Minutes the requester waited (calendar hours). |
|
|
float |
[en] Minutes the requester waited (business hours). |
|
|
float |
[en] Minutes the agent waited (calendar hours). |
|
|
float |
[en] Minutes the agent waited (business hours). |
Tickets
Replication type: Incremental
Main object
Zendesk tickets with request details, routing, and linkage metadata.
| Campo | Tipo | |
|---|---|---|
|
text |
[en] Unique identifier of the ticket. |
|
|
text |
[en] Status of the ticket (new, open, pending, hold, solved, closed). |
|
|
text |
[en] Identifiers of agents following the ticket. |
|
|
text |
[en] Destination name in the ticket source metadata. |
|
|
text |
[en] Destination address in the ticket source metadata. |
|
|
text |
[en] Source name captured for the ticket. |
|
|
text |
[en] Source address captured for the ticket. |
|
|
text |
[en] Relationship indicator in the ticket source metadata. |
|
|
text |
[en] Channel through which the ticket was created. |
|
|
text |
[en] First comment/body of the ticket (somente leitura). |
|
|
text |
[en] Tags aplicadas ao ticket. |
|
|
text |
[en] For incident tickets, ID of the related problem ticket. |
|
|
boolean |
[en] Indicates if channelback is allowed for this ticket. |
|
|
timestamp |
[en] When the ticket record was last updated. |
|
|
text |
[en] User who submitted the ticket (autor do primeiro comentário). |
|
|
text |
[en] Agent currently assigned to the ticket. |
|
|
text |
[en] Identifier of the brand linked to this ticket. |
|
|
timestamp |
[en] Due date/time for task-type tickets. |
|
|
text |
[en] Satisfaction rating or state (offered/unoffered) when available. |
|
|
boolean |
[en] True when the ticket has public comments. |
|
|
text |
[en] User who requested the ticket. |
|
|
text |
[en] Forum topic the ticket came from (when applicable). |
|
|
text |
[en] Original recipient address used for notifications. |
|
|
text |
[en] Ticket subject text. |
|
|
text |
[en] Organization linked to the requester. |
|
|
text |
[en] URL for the ticket record. |
|
|
text |
[en] Ticket type (problem, incident, question, task). |
|
|
timestamp |
[en] When the ticket record was created. |
|
|
text |
[en] Identifiers of sharing agreements applied to the ticket. |
|
|
boolean |
[en] Indicates if agents can add attachments to comments. |
|
|
text |
[en] IDs de follow-ups criados a partir deste ticket (visíveis após o fechamento). |
|
|
text |
[en] Identifiers of users currently em cópia no ticket. |
|
|
text |
[en] Priority level (urgent, high, normal, low). |
|
|
text |
[en] Dynamic content placeholder for the subject, or the subject text itself. |
|
|
text |
[en] IDs de agentes ou usuários finais atualmente em cópia no ticket. |
|
|
boolean |
[en] Indicates if a problem-type ticket has linked incidents. |
|
|
text |
[en] Group assigned to the ticket. |
|
|
text |
[en] External identifier to link the ticket to another system. |
zendesk_tickets__fields
Custom field values expanded per ticket.
Users
Replication type: Incremental
Zendesk users with profile, role, and access details.
| Campo | Tipo | |
|---|---|---|
|
text |
[en] Unique identifier of the user. |
|
|
text |
[en] Tags assigned to the user when tagging is enabled. |
|
|
text |
[en] Language/region configured for the user. |
|
|
boolean |
[en] Indicates if the agent is shared from another Zendesk instance (ticket sharing). |
|
|
timestamp |
[en] When the user record was last updated. |
|
|
boolean |
[en] Flags whether the agent has restrictions (false for admins/unrestricted agents). |
|
|
text |
[en] Identifier of the user’s organization. |
|
|
text |
[en] Primary phone number of the user. |
|
|
text |
[en] Custom role ID for agents on Enterprise plans or above. |
|
|
timestamp |
[en] Date/time of the last sign-in or authenticated access. |
|
|
text |
[en] Numeric role type (0 custom agent, 1 light agent, 2 chat agent, 3 chat contributor, 4 admin, 5 billing admin). |
|
|
text |
[en] Identifier of the user’s default group. |
|
|
boolean |
[en] Indicates whether the user is suspended; suspended users cannot sign in. |
|
|
boolean |
[en] Allows access to CSV reports in reporting (plans with this feature only). |
|
|
boolean |
[en] Indicates whether the user is active (not deleted). |
|
|
boolean |
[en] Indicates if two-factor authentication is enabled. |
|
|
text |
[en] Internal notes stored about the user. |
|
|
text |
[en] IANA time zone set for the user. |
|
|
boolean |
[en] Indicates if the user can moderate forums. |
|
|
boolean |
[en] Flags if any identity for the user is verified. |
|
|
text |
[en] Full name of the user. |
|
|
boolean |
[en] If true, the user can create only private comments. |
|
|
text |
[en] URL for the user record. |
|
|
timestamp |
[en] When the user record was created. |
|
|
text |
[en] Time zone string set for the user. |
|
|
text |
[en] Indicates whether the phone number is shared. |
|
|
text |
[en] Alternate name shown to end users. |
|
|
text |
[en] Role label for the user (end-user, agent, admin). |
|
|
text |
[en] Additional details stored about the user (ex.: endereço). |
|
|
text |
[en] Signature configured for the user (agents/admins only). |
|
|
boolean |
[en] Indicates if the user is shared from another instance (ticket sharing). |
|
|
text |
[en] External identifier from another system (case sensitive). |
|
|
text |
[en] Primary email address of the user. |
|
|
boolean |
[en] Flags if the user is a chat-only agent. |
|
|
text |
[en] Access scope for tickets (organization, groups, assigned, requested, or null). |
Notes
- Part of this documentation was automatically generated by AI and may contain errors. We recommend verifying critical information

