> ## Documentation Index > Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Zendesk Support Connector with Upsert ## Intro Zendesk Support Connector with Upsert provides a cloud-based customer service program that includes ticketing, self-service options, and customer support features. It enhances productivity, processes, and pipelines for your sales teams. Use Domo’s Zendesk Support Connector with Upsert to compile reports about tickets, users, and more. To learn more about the Zendesk Support Connector with Upsert API, visit their page ([https://developer.Zendesk Support Connector with Upsert.com/rest\_api/docs/core/introduction](https://developer.zendesk.com/rest_api/docs/core/introduction "https://developer.zendesk.com/rest_api/docs/core/introduction") ). The Zendesk Support Connector with Upsert is a "Cloud App" Connector, meaning it retrieves data stored in the cloud. In the Data Center, you can access the Connector page for this and other Cloud App Connectors by clicking ****Cloud App**** in the toolbar at the top of the window. You connect to your Zendesk Support Connector with Upsert account in the Data Center. This topic discusses the fields and menus that are specific to the Zendesk Support Connector with Upsert user interface. To add DataSets, set update schedules, and edit DataSet information, see [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector"). ## Prerequisites To connect to your Zendesk Support Connector with Upsert account and create a DataSet, you must have the following: * The username for your Zendesk Support Connector with Upsert account * The API token OR password for your Zendesk Support Connector with Upsert account * The Zendesk Support Connector with Upsert URL for your company * The user must be a Zendesk admin. * You need to verify the primary email address associated with the user account. To use a password, enable API authentication using an agent's email address and password. This may already be enabled for sign-in to the Zendesk Support Connector with Upsert Support mobile apps. Zendesk Support Connector with Upsert recommends that you use API tokens to keep your agents' passwords safe. API tokens are managed in the Zendesk Support Connector with Upsert Support Admin interface at ****Admin > Channels > API****. The page lets you view, add, or delete tokens. More than one token can be active at the same time. Deleting a token deactivates it permanently. ## Connecting to Your Zendesk Support Connector with Upsert Account This section enumerates the options in the **Credentials** and **Details** panes in the Zendesk Support Connector with Upsert page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most Connector types and are discussed in great detail in [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector"). ### Credentials Pane This pane contains fields for entering credentials to connect to your Zendesk Support Connector with Upsert account. The following table describes what is needed for each field:

Field	Description
Username	Enter the username you use to log into your Zendesk Support Connector with Upsert account.
Authenticated By	Specify whether you want to use your Zendesk Support Connector with Upsert API token or password to authenticate.
API Token or Password	Enter your Zendesk Support Connector with Upsert API token or password. This must match what you have selected in the Authenticate By menu. For example, if you selected API Token for Authenticate By , you must enter your API token in this field, not your password.
Zendesk Support Connector with Upsert URL	Enter the URL for your company's Zendesk Support Connector with Upsert instance.

Once you have entered valid Zendesk Support Connector with Upsert credentials, you can use the same account any time to create a new Zendesk Support Connector with Upsert. You can manage Connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Manage Connector/Adapter Accounts](https://domo-support.domo.com/s/article/360042926054?language=en_US "Manage Connector/Adapter Accounts"). ### Details Pane This pane contains a primary **Reports** menu, along with various other menus which may or may not appear depending on the report type you select.

Description

Report

Select the Zendesk Support Connector with Upsert report you want to run. The following reports are available:

Report Name	Description
Brands	Retrieves a list of all brands for your account sorted by name.
Organizations	Retrieves information about the organizations in your Zendesk Support Connector with Upsert instance.
Specify Query	Allows you to build a customized report by entering your own Zendesk Support Connector with Upsert search query. You can also select from two premade queries— Open Tickets and Closed Tickets . You can use these to return the number of open and closed tickets for your Zendesk Support Connector with Upsert instance. For more information about entering Zendesk Support Connector with Upsert queries, see Zendesk Support Connector with Upsert Support search reference .
Tickets	Retrieves information about the created and updated tickets.
Ticket Activities	Retrieves Lists ticket activities in the last 30 days, affecting the agent making the request.
Ticket Audits	Retrieve the list of ticket audits.
Ticket Fields	Retrieve tickets fields in your Zendesk Support Connector with Upsert instance.
Ticket Forms - Agent Conditions	Retrieve ticket forms in your Zendesk Support Connector with Upsert instance and displays the condition sets for agent workplace.
Ticket Forms - End User Conditions	Retrieve ticket forms in your Zendesk Support Connector with Upsert instance and displays the condition sets for end user products.
Ticket Comments	Retrieves the comments on the tickets.
Ticket Metric Events	Retrieves the ticket metric events.
Users	Retrieves the information about the users in your Zendesk Support Connector with Upsert instance.

Associated Data

Select the associated data you want loaded along with the tickets.

Include Attachments

Specify whether you would like to include the attachments in the results.

Select the date to start retrieving data on the first run. Subsequent runs will automatically retrieve newly created and updated tickets, users or organizations

Select the date to start retrieving data on the first run. Subsequent runs will automatically retrieve newly created and updated items. If you modify the date after the first run, this date will be used for the next run and the existing data will be replaced.

Date Selection

Select the Date to start retrieving data on the first run. Subsequent runs will automatically retrieve newly created and updated tickets, users, or organizations.

Single Date

Select whether the report data is for a specific date or for a relative number of days back from today.

Specific Date

Select the specific date using the date selector.

Relative Date

Enter the number of days back that you would like to get data for in the Days Back field. Specify either today or 0, yesterday or 1, or today-7 or 7 to get data for 7 days into the past.

Legacy Schema Selection

Select this check box to use legacy schema for backward compatibility with the Zendesk Support Connector with Upsert Connector.

Exclude Deleted Records

Select this check box to exclude the deleted records from the data.

### Other Panes For information about the remaining sections of the Connector interface, including how to configure schedule, retry, and update options, see [Adding a DataSet Using a Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector"). ## FAQs The base URL for the Zendesk Support Connector with Upsert Upsert connector is [https://{subdomain}.Zendesk Support Connector with Upsert.com/api/v2](https://%7Bsubdomain%7D.zendesk.com/api/v2 "https://\{subdomain}.zendesk.com/api/v2").

Report Name	Enpoint URL
Brands	/api/v2/brands.json
Organizations	/incremental/organizations.json
Specify Query	/api/v2/search/export.json
Tickets	/incremental/tickets.json
Ticket Activities	/api/v2/activities.json
Ticket Audits	/ticket\_audits.json
Ticket Fields	/ticket\_fields.json
Ticket Forms - Agent Conditions	/ticket\_forms.json
Ticket Forms - End User Conditions	/ticket\_forms.json
Ticket Comments	/tickets/{currentTicketId}/comments.json
Ticket Metric Events	/incremental/ticket\_metric\_events.json
Users	/incremental/users.json

You need the Zendesk Support Connector with Upsert username, password or API token, and the Zendesk Support Connector with Upsert instance URL. The Zendesk Support Connector with Upsert user account used for this connector must be an Admin within Zendesk Support Connector with Upsert. As often as needed. No Yes The Zendesk Support Connector with Upsert supports a Merge mode along with the Append and Replace modes to update your dataset. The Merge mode replaces all updated rows, while any new rows are appended. Thus, it avoids duplicate entries. The Zendesk Support Connector with Upsert supports the Append and Replace modes to update your datasets.