--- title: YouTrack API Integration on Truto slug: youtrack category: Ticketing canonical: "https://truto.one/integrations/detail/youtrack/" --- # YouTrack API Integration on Truto **Category:** Ticketing **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Users** — The User object represents a User. ### Unified Ticketing API - **Attachments** — Attachments are the files associated with a ticket or a comment. - **Collections** — Tickets and contacts can be grouped into Collections. Collection resource usually maps to the various grouping systems used in the underlying product. Some examples are lists, projects, epics, etc. You can differentiate between these grouping systems using the type attribute of a Collection. - **Comments** — Comments represent the communication happening on a Ticket, both between a User and a Contact and the internal things like notes, private comments, etc. A Ticket can have one or more Comments. - **Tags** — Tags represent a common classification approach used in various ticketing systems. A Ticket may have one or more Tags associated with them. - **Ticket Priorities** — Ticket Priorities represent the intended order in which the Tickets should be worked on. Some products provide customizing the Ticket Priorities. - **Ticket Status** — Ticket Status represents the completion level of the Ticket. Some products provide customizing the Ticket Status. - **Ticket Types** — Ticket Types represent the classification system used by the underlying products for Tickets. Some examples are bugs, feature, incident, etc. - **Tickets** — Core resource which represents some work that needs to be carried out. Tickets are usually mapped to issues, tasks, work items, etc. depending on the underlying product. - **Users** — Users represent the people using the underlying ticketing system. They are usually called agents, team members, admins, etc. ## How it works 1. **Link your customer's YouTrack account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach YouTrack.** The Proxy API is a 1-to-1 mapping of the YouTrack API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Escalate support conversations into YouTrack engineering tickets** — Customer support SaaS platforms can let agents push bug reports and feature requests directly into YouTrack as tickets, then pull back status updates and internal comments so support teams stay informed without needing YouTrack seats. - **Auto-create YouTrack bugs from error monitoring and observability data** — Error tracking and observability platforms can automatically generate YouTrack tickets with stack traces as attachments, assigned priorities, and relevant tags — eliminating manual copy-paste workflows for engineering teams. - **Pull engineering progress into product roadmap and portfolio tools** — Product management platforms can continuously sync ticket statuses, priorities, and collections from YouTrack to give PMs and executives real-time visibility into development velocity without navigating YouTrack's developer-centric UI. - **Sync YouTrack users and assignees into your SaaS directory** — Any B2B SaaS that needs to map actions to specific people — whether for reporting, access control, or attribution — can pull YouTrack user data through Truto's Unified User Directory API to keep identities consistent across systems. - **Bridge QA and testing platforms with YouTrack backlogs** — QA and test management tools can push failed test results as YouTrack tickets with attachments and tags, enabling developers to triage bugs directly in their existing workflow while QA teams track resolution progress from their own platform. ## What you can build - **Two-way ticket and comment sync** — Keep tickets and comments synchronized between your product and YouTrack so both teams see real-time updates without switching tools. - **One-click bug escalation with attachments** — Let your users create YouTrack tickets with screenshots, logs, and stack traces attached directly from your product's UI. - **Live ticket status dashboard** — Pull ticket statuses and priorities from YouTrack to display engineering progress inside your product's reporting or roadmap views. - **Automated ticket creation with priority and tag mapping** — Programmatically create YouTrack tickets with the correct priority, type, and tags based on events detected in your platform. - **Unified user directory across ticketing tools** — Sync YouTrack users into your product's identity layer so you can correctly attribute assignees, reporters, and commenters across integrations. - **Sprint and collection progress tracking** — Pull YouTrack collections such as sprints and epics into your product to give stakeholders a high-level view of team capacity and delivery timelines. ## FAQs ### What authentication method does the YouTrack integration use? YouTrack supports OAuth 2.0 and permanent token-based authentication for API access. Truto handles the auth flow so your end users can connect their YouTrack accounts without your team managing tokens or refresh logic. ### How does YouTrack handle statuses, priorities, and types differently from other ticketing tools? YouTrack does not have hardcoded Status, Priority, or Type fields. These are implemented as configurable custom fields (e.g., a 'State' type field) that vary per project. Truto's Unified Ticketing API maps these to standard Ticket Status, Ticket Priorities, and Ticket Types resources so you don't have to parse each project's custom field schema yourself. ### Are there specific tools available for this integration today? YouTrack tools are built on request. The integration is supported through Truto's Unified Ticketing API (covering Tickets, Comments, Attachments, Tags, Ticket Status, Ticket Priorities, Ticket Types, Collections, and Users) and the Unified User Directory API. Contact Truto to request activation. ### Can I sync both internal and public comments from YouTrack Helpdesk projects? YouTrack supports visibility toggles on comments (internal vs. public), which is especially relevant for Helpdesk projects. The Comments resource in the Unified Ticketing API can surface this data so your integration can distinguish between developer-facing notes and customer-visible responses. ### Does Truto handle pagination and rate limits for the YouTrack API? Yes. Truto manages pagination and rate limit handling for YouTrack's REST API automatically, so your team doesn't need to build retry logic or cursor management into your integration code. ### Can I filter and search YouTrack tickets through the integration? YouTrack's REST API supports a powerful native query language for filtering issues (e.g., 'State: Unresolved assign: me'). Truto can leverage this to efficiently fetch filtered ticket sets rather than pulling and filtering entire datasets client-side.