# TOPdesk Jira Integration

Integrate TOPdesk and Jira to synchronize incidents, tasks, and service requests across ITSM and DevOps teams using ZigiOps - a secure, no-code integration platform.

This integration enables real-time or scheduled data synchronization, eliminates manual updates, and ensures a single source of truth between TOPdesk and Jira.

<div><figure><img src="/files/ktCOxV9AxYxZOJQr5Wtt" alt=""><figcaption></figcaption></figure> <figure><img src="/files/5omNuSIY2sCNBxSVuSzw" alt=""><figcaption></figcaption></figure> <figure><img src="/files/m2hmYDfd1luBvPwEImhF" alt=""><figcaption></figcaption></figure> <figure><img src="/files/qhGhhdptFlbeRRSaQC2c" alt=""><figcaption></figcaption></figure> <figure><img src="/files/5kH9lWK0ZitznCzfnkDN" alt=""><figcaption></figcaption></figure> <figure><img src="/files/wNw1BoieOWp1UnvuorM0" alt=""><figcaption></figcaption></figure> <figure><img src="/files/GYSZDnF3gK81qcBBmTwf" alt=""><figcaption></figcaption></figure> <figure><img src="/files/mCgRirINq3ptyz7pQUQe" alt=""><figcaption></figcaption></figure></div>

### **Integration video**

{% embed url="<https://youtu.be/ihtzvQdSins?si=hB0rM076TC2xFN9d>" %}

### What can I integrate between TOPdesk and Jira?

ZigiOps can integrate any TOPdesk entity (Incidents, Changes, etc.) with any Jira issue type (Tasks, Bugs, Issues, etc.), allowing you to build custom workflows tailored to your processes and data models.

Out of the box, ZigiOps provides ready-made integration templates for the most common TOPdesk and Jira scenarios, including:

* TOPdesk Incidents to Jira Tasks
* Jira Tasks to TOPdesk Incidents

These templates serve as preconfigured starting points and can be customized or extended to support additional TOPdesk entities, Jira issue types, and business-specific workflows.

| Common TOPdesk entities | Common Jira issue types | Common fields typically synchronized                                                                           |
| ----------------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------- |
| Incident (First Line)   | Task / Issue            | Brief description / Summary, Description, Priority, Status / State, Operator / Assignee, Comments, Attachments |
| Incident (Second Line)  | Task / Issue            | Brief description / Summary, Description, Priority, Status / State, Operator / Assignee, Comments, Attachments |
| Change                  | Issue / Task            | Brief description / Summary, Description, Priority, Status / State, Operator / Assignee, Comments, Attachments |
| Any TOPdesk entity      | Any Jira issue type     | Standard + custom fields, Comments, Attachments, Status/State mappings, Correlation ID (recommended)           |

### How does the TOPdesk and Jira integration work?

ZigiOps connects TOPdesk and Jira using their native APIs and acts as a secure integration layer between the two systems.

* No scripting or custom development required
* Configured entirely through the ZigiOps UI
* Supports polling- and event-based synchronization
* Does not permanently store transferred business data

### Prerequisites and permissions

Before enabling the TOPdesk and Jira integration, ensure the following prerequisites are met.

| Integration Scenario            | TOPdesk - Authentication | TOPdesk - Permissions                               | TOPdesk - Environment                                | Jira - Authentication | Jira - Permissions                                       | Jira - Environment                                             |
| ------------------------------- | ------------------------ | --------------------------------------------------- | ---------------------------------------------------- | --------------------- | -------------------------------------------------------- | -------------------------------------------------------------- |
| TOPdesk Incidents to Jira Tasks | Username + Password      | Read / Write access to Incidents and target modules | TOPdesk (any supported version) Cloud or On-Premises | Username + API Token  | Create / Read / Update issues; Access to target projects | Jira Software or Jira Service Management, Version 7.x or newer |
| Jira Tasks to TOPdesk Incidents | Username + Password      | Read / Write access to Incidents and target modules | TOPdesk (any supported version) Cloud or On-Premises | Username + API Token  | Create / Read / Update issues; Access to target projects | Jira Software or Jira Service Management, Version 7.x or newer |

### Setup

1. Log in to your ZigiOps instance.
2. Navigate to ZigiOps - Configurator.
3. Load the desired TOPdesk and Jira integration template.
4. Select the corresponding Integrated Systems (TOPdesk and Jira).
5. Click **Save** to continue.
6. Enable the integration using the slider button located in the middle section of the screen.

### Mapping examples

Below are typical field-mapping examples used across the TOPdesk and Jira integration scenarios. Mappings can be customized per use case.

**Example: TOPdesk Incident to Jira Task**

| TOPdesk field     | Jira field  | Advanced Field Mapping Example                              |
| ----------------- | ----------- | ----------------------------------------------------------- |
| Brief description | Summary     | -                                                           |
| Request           | Description | -                                                           |
| Priority          | Priority    | -                                                           |
| Processing status | Status      | Logged - To Do, In Progress - In Progress, Completed - Done |
| Operator          | Assignee    | -                                                           |
| Action (comments) | Comments    | -                                                           |
| Attachments       | Attachments | -                                                           |

### What data can be synchronized?

* Standard fields
* Custom fields
* Status transitions
* Comments and actions
* Attachments
* Operator / Assignee (configurable)

### Frequently asked questions (FAQ)

<details>

<summary>Is the integration bi-directional?</summary>

Yes. All scenarios support bi-directional synchronization, configurable per field.

</details>

<details>

<summary>How are update loops prevented?</summary>

ZigiOps uses correlation IDs and internal logic to prevent circular updates.

</details>

<details>

<summary>Does ZigiOps store my data?</summary>

No. ZigiOps does not permanently store transferred business data.

</details>

### Related resources

* [How to connect TOPdesk to ZigiOps](#)
* [How to connect Jira to ZigiOps](#)
* [Data mapping fundamentals](#)
* [TOPdesk and Jira integration troubleshooting](#)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zigiwave.com/integration-catalog/topdesk-jira-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.