Bitrix24-YouTrack Integration: Bidirectional Task Synchronization

A client submits a bug report to support; the manager creates a task in Bitrix24, then goes to YouTrack and duplicates the issue. The developer closes the issue, but the manager doesn't know — the client gets a "still working" response for an already fixed problem. Two trackers without linkage mean double work and constant information lag. We design a middleware that listens for events in both systems and transforms them into entities of the other system, eliminating manual transfer and delays. Our engineers have over five years of experience with YouTrack and Bitrix24, so we know all the pitfalls and guarantee a stable solution. We provide documentation, employee training, and post-deployment support. The result is a unified information space for developers and managers, saving up to 30 hours per month per employee.

The Problem: Broken Workflow and Duplicate Efforts

Manual task duplication between Bitrix24 and YouTrack leads to:

• Outdated statuses — developers mark an issue done, but the project manager still sees it as "in progress."
• Lost information — comments and time logs are scattered across systems.
• Double data entry — wasting hours on creating and maintaining parallel records.

Our middleware solves these issues by creating a bidirectional link between the two trackers.

How We Set Up the Integration

Step 1: Obtain API Tokens

• YouTrack: Generate a Permanent Token (Profile → Authentication → New Token). This is the recommended authentication method for server integrations per the YouTrack REST API documentation.
• Bitrix24: Get an OAuth token with task and user scopes.

Step 2: Deploy the Middleware

We provide a Docker image that you run on your server (Linux VPS recommended). The middleware acts as a bridge between the two systems.

Step 3: Configure Field Mapping

Define correspondences for title, description, assignee, status, and project. Example configuration:

middleware: youtrack: token: "perm:YOUR_TOKEN" base_url: "https://yourcompany.youtrack.cloud" bitrix24: webhook_url: "https://yourdomain.bitrix24.ru/rest/1/TOKEN/" mapping: fields: - b24: TITLE yt: summary - b24: DESCRIPTION yt: description transform: "html_to_md" statuses: - b24: 2 yt: Open - b24: 3 yt: "In Progress" 

Step 4: Set Up Webhooks

• In YouTrack: Settings → Webhooks → Add webhook to send events to the middleware.
• In Bitrix24: Configure outbound webhooks for task events (e.g., ONTASKUPDATE).

Step 5: Test and Go Live

We run tests in a staging environment, then deploy to production with monitoring.

Architecture of the Synchronization

The integration uses the REST APIs of both systems. YouTrack offers a full-featured API for issues, projects, agile boards, and time tracking. Bitrix24's REST API handles tasks, users, and custom fields. The middleware processes events bidirectionally:

Bitrix24 (task event) → Webhook → Middleware → YouTrack REST API → Issue YouTrack (workflow/webhook) → Middleware → Bitrix24 REST API → Task 

YouTrack supports two notification mechanisms: Webhooks (simpler) and Workflows (JavaScript scripts for fine-grained control). Workflows allow filtering by field, project, or issue type — giving you more flexibility.

Field Mapping Details

Description conversion: Bitrix24 stores HTML; YouTrack uses Markdown (with extensions). The middleware converts via an intermediate AST.

Status Mapping

YouTrack uses a state machine — each project has its own set of states. Our middleware supports configurable mapping:

For states not present in Bitrix24, the middleware adds a comment explaining the status and optionally closes or suspends the task.

Time Tracking Synchronization

Both YouTrack and Bitrix24 support time logs. The middleware merges records:

• YouTrack → Bitrix24: When a work item is added in YouTrack (event issue.updated, field workItems), the middleware creates a time log in Bitrix24 via task.elapseditem.add. Duration, date, and comment are passed.
• Bitrix24 → YouTrack: When a time log is added in Bitrix24 (event ONTASKELAPSEDTIMEADD), the middleware creates a work item in YouTrack via POST /api/issues/{id}/timeTracking/workItems.

To prevent duplicates, the middleware maintains a mapping table of time entries, each with a unique sync_id.

Agile Board Integration

YouTrack Agile Boards display issues on Kanban/Scrum boards. Bitrix24 has its own Kanban. The middleware does not sync visual layout but ensures:

• Dragging an issue on a YouTrack board (changing State) updates the Bitrix24 task status.
• Changing a stage on a Bitrix24 Kanban board updates the YouTrack issue State.
• YouTrack sprints can be mapped to Bitrix24 task groups or a custom UF_SPRINT field.

Preventing Sync Loops

The middleware tags the source of each update in a custom field in both systems. When a webhook arrives, it checks the tag — if the update originated from the middleware itself, processing is skipped.

Authentication

• YouTrack: Permanent Token (Profile → Authentication → New Token). Works for Cloud and Server. The token inherits the permissions of the issuing user.
• Bitrix24: OAuth 2.0 with scope task,user.
• Data flows only through the middleware — no direct access between systems.

What's Included in the Work

We assess your project individually. Timelines range from 2 to 5 business days depending on complexity. Cost is determined after analysis. Contact us for a consultation. We guarantee 24/7 stable sync. Our experience includes over five years with Bitrix and YouTrack and dozens of successful integrations. Certified engineers ensure reliability. Order integration setup — eliminate task duplication and wasted time. Reach out to get a quote.