> For the complete documentation index, see [llms.txt](https://docs.mybytes.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mybytes.tech/zoho-desk/jira-connector-for-zoho-desk/administrator-guide/getting-started.md).

# 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](/atlassian-cloud/zoho-desk-for-jira/administrator-guide/getting-started.md) 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](/zoho-desk/jira-connector-for-zoho-desk/user-guide/using-the-add-on.md), 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="/files/uNV1kNDV2x0tPhZoaZ5A" alt="" width="375"><figcaption></figcaption></figure></div>

Click **Accept** when prompted.

<figure><img src="/files/Xs6B4BK4e4iWHP5CZb1u" alt=""><figcaption></figcaption></figure>

### Configuring API Token

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

<figure><img src="/files/xxelRR1QhFVbK02GdLIb" 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 [Getting Started](/atlassian-cloud/zoho-desk-for-jira/administrator-guide/getting-started.md#step-two-authorize-connection)to make sure your Jira connection is set up properly.

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

<figure><img src="/files/u5W4FC6QDLLeeIIrVcvJ" 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="/files/TkP2LOgdLDfjEW6YzoPO" 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 [Getting Started](/atlassian-cloud/zoho-desk-for-jira/administrator-guide/getting-started.md#step-five-configure-field-mappings).

### 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!