# Getting Started

{% hint style="info" %}
**Please Note: To use this add on, an installation of** [**Zoho Desk for Jira**](https://marketplace.atlassian.com/apps/1234529/zoho-desk-for-jira?hosting=cloud\&tab=overview) **in the Atlassian marketplace is required.**
{% endhint %}

Welcome! This section will guide you through the initial setup and features of our application, ensuring a smooth start to your journey.

### Prerequisite

To use this add-on effectively, make sure Zoho Desk for Jira is installed from the Atlassian Marketplace.

You will also need to have Connection and Mappings configured in Jira.

Please follow the steps in [getting-started](https://docs.mybytes.tech/atlassian-cloud/zoho-desk-for-jira/administrator-guide/getting-started "mention") to setup the add on Jira.

If you need further assistance, don’t hesitate to contact our support team at **<support@mybytes.tech>**

### Quick Setup Guide

Watch the video below for a quick setup guide. For more details, refer to the step-by-step documentation and [using-the-add-on](https://docs.mybytes.tech/zoho-desk/jira-connector-for-zoho-desk/user-guide/using-the-add-on "mention"), as the video does not cover all functionalities.

{% embed url="<https://youtu.be/FXf2Q_Ch15U>" %}

### Installing the add on

Ensure you install the add-on from the Zoho Marketplace.

Once the add-on is installed, you will need to authorize the connection through Zoho OAuth.

Click Authorize located on the top right.

<div align="left"><figure><img src="https://4112598543-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBHvod0TlmybkT2IeKnoL%2Fuploads%2F66FpcSKwRZ2xU6w5KgXc%2Fafter.install.1.png?alt=media&#x26;token=caa42bc9-d4e5-4faa-9566-c2de4d9ad861" alt="" width="375"><figcaption></figcaption></figure></div>

Click **Accept** when prompted.

<figure><img src="https://4112598543-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBHvod0TlmybkT2IeKnoL%2Fuploads%2FYqMaq1IrblQLWzZXzC2k%2Fafter.install.2.png?alt=media&#x26;token=dcd3484a-31f9-4662-b6fd-97750c35357e" alt=""><figcaption></figcaption></figure>

### Configuring API Token

After the OAuth connection is authorized, you'll need to configure API Token.

<figure><img src="https://4112598543-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBHvod0TlmybkT2IeKnoL%2Fuploads%2Fb80jm3CZO1GylMwU39Eh%2FScreenshot%202024-06-29%20at%2011.46.36%20AM.png?alt=media&#x26;token=f1a41b5a-555d-4d7d-b466-5b4cd98b57a9" alt=""><figcaption></figcaption></figure>

To get the API Token, you will need to have Zoho Desk for Jira installed and configured in Atlassian Marketplace.&#x20;

Navigate to your Jira instance and follow the steps in [#step-two-authorize-connection](https://docs.mybytes.tech/atlassian-cloud/zoho-desk-for-jira/administrator-guide/getting-started#step-two-authorize-connection "mention")to make sure your Jira connection is set up properly.

Once you have the Connection configured in Jira, click **Copy Token**

<figure><img src="https://4112598543-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBHvod0TlmybkT2IeKnoL%2Fuploads%2FUAfdmIaOymzFteV7o5Gy%2F2.png?alt=media&#x26;token=3e28c621-7f28-4918-a6ae-986214445266" alt=""><figcaption></figcaption></figure>

**NOTE: Please make sure that the Portal Name is correct!**

Paste the copied token into the textbox.

### Enabling Auto Update for Tickets

Once you have configured the API Token, please Navigate to **Preference** tab.

Make sure the status shows as Connected.

Verify that the Connection Name and Jira Base Url are correct.

<figure><img src="https://4112598543-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBHvod0TlmybkT2IeKnoL%2Fuploads%2FT40LtJmtD6lEUOkzo1cL%2F3.png?alt=media&#x26;token=e9e4a56d-fdfe-46f1-8ab6-0b130e485532" alt=""><figcaption></figcaption></figure>

To enable Auto Sync, click the toggle button.

This feature ensures that Tickets and Jira Issues remain up-to-date with the latest changes. Synchronisation is based on the field mappings you’ve configured in Jira.&#x20;

This ensures seamless communication and up-to-date information flow between Zoho Desk and Jira!

### Manage Field Mapping

Field Mapping defines which fields are synchronised when you Push or Pull Tickets. To manage these fields, follow the steps in [#step-five-configure-field-mappings](https://docs.mybytes.tech/atlassian-cloud/zoho-desk-for-jira/administrator-guide/getting-started#step-five-configure-field-mappings "mention").

### Support

If you need further assistance, don’t hesitate to contact our support team at **<support@mybytes.tech>**. We’re here to help!

Thank you for using Jira Connector for Zoho Desk!