How to connect YouTrack to Albato

YouTrack: Project management integrations
YouTrack
·
9/18/2023
·
3 min. read

YouTrack - everything in one place. Track tasks, manage projects, maintain a knowledge base, support your customers, collaborate, and deliver great products.

Available triggers

Triggers are the events that trigger the automation, All triggers run in real time, i,e, data is transferred in the moment the event occurs

  • Issue created
  • Issue updated

Available actions

Actions are what Albato performs when your automation is running, Actions also allow you to transfer data to other apps and systems

  • New issue
  • Update issue
  • Find an issue

Before setting up integrations with YouTrack, connect the tool to Albato.

To do this, go to the Apps section and click the Add a connection button.

Example.png

Select the app and click the Add a connection button.

YouTrack.png

Come up with a name for your connection.

Enter your Domain and API key.

Click the Continue button.

YouTrack (1).png

How to get API key

Go to your YouTrack account.

Either copy the ID from the browser address bar or enter the name of the workspace you used to create the account. Go to the list of system users, select the user who will access the integration, and open the Account Security tab.

Next, create a new token and copy its value.

YouTrack (2).png

Paste the token into the Albato connection field.

The first part of the connection is finished. To receive tickets from YouTrack, we need to create two more workflows in YouTrack, write our JS code there and insert the webhook from the connection into them.

Go to the Workflows tab.

YouTrack (3).png

Create a new Workflow.

YouTrack (4).png

Set a name for your Workflow

YouTrack (5).png

and select the rule:

YouTrack (6).png

Paste the following code:

const albatoHook = '{{albatoHook}}';
const entities = require('@jetbrains/youtrack-scripting-api/entities');
const http = require('@jetbrains/youtrack-scripting-api/http');
const workflow = require('@jetbrains/youtrack-scripting-api/workflow');

function periodToHours(period) {
  return period ? (
    period.getMinutes() / 60 +
    (
      period.getHours() +
      period.getDays() * 8 +
      period.getWeeks() * 40
    )
  ) : 0;
}

function formatValue(value) {
  if (typeof value === 'object' && value !== null) {
    switch (value.$$type) {
      case 'User':
        value = value.fullName;
        break;
      default:
        if ('getPeriodType' in value) {
          value = periodToHours(value);
        } else if (value.constructor.name === 'ImmutableIterableWW') {
          const array = value;
          value = [];
          array.forEach(item => value.push(item.name));
        } else {
          value = value.name;
        }
    }
  }
  return value === undefined ? null : value;
}
exports.rule = entities.Issue.onChange({
  title: workflow.i18n('Send webhook to Albato'),
  guard: function(ctx) {
    return ctx.issue.becomesReported && ctx.issue.isReported;
  },
  action: function(ctx) {
    const issue = ctx.issue;
    const fields = {};
    for (let field in issue.fields) {
      fields[field] = formatValue(issue.fields[field]);
    }
    const tags = [];
    issue.tags.forEach(nameTag => tags.push(nameTag.name));
    const payload = {
      'event': 'newTicket',
      'ticketUrl': issue.url,
      'tags': tags,
      'id': issue.id,
      'summary': issue.summary,
      'description': issue.description,
      'projectId': issue.project.key,
      'project': issue.project.name,
      'dateCreate': issue.created,
      'dateUpdate': issue.updated,
      'fields': fields,
    };
    console.log(issue.tags);
    const connection = new http.Connection(albatoHook, null, 2000);
    connection.addHeader('content-type', 'application/json');
    const response = connection.postSync('', null, payload);
    if (!response.isSuccess) {
      console.warn('Failed to post webhook to Albato. Details: ' + response.toString());
    }
  },
});

This code catches only the creation of tasks, and the following code catches changes to tasks. You can work in one rule, or you can create an additional rule and add the following code to it:

const albatoHook = '{{albatoHook}}';
const entities = require('@jetbrains/youtrack-scripting-api/entities');
const http = require('@jetbrains/youtrack-scripting-api/http');
const workflow = require('@jetbrains/youtrack-scripting-api/workflow');

function periodToHours(period) {
  return period ? (
    period.getMinutes() / 60 +
    (
      period.getHours() +
      period.getDays() * 8 +
      period.getWeeks() * 40
    )
  ) : 0;
}

function formatValue(value) {
  if (typeof value === 'object' && value !== null) {
    switch (value.$$type) {
      case 'User':
        value = value.fullName;
        break;
      default:
        if ('getPeriodType' in value) {
          value = periodToHours(value);
        } else if (value.constructor.name === 'ImmutableIterableWW') {
          const array = value;
          value = [];
          array.forEach(item => value.push(item.name));
        } else {
          value = value.name;
        }
    }
  }
  return value === undefined ? null : value;
}
exports.rule = entities.Issue.onChange({
  title: workflow.i18n('Send webhook to Albato'),
  guard: function(ctx) {
    return !ctx.issue.becomesReported && ctx.issue.isReported;
  },
  action: function(ctx) {
    const issue = ctx.issue;
    const fields = {};
    for (let field in issue.fields) {
      fields[field] = formatValue(issue.fields[field]);
    }
    const tags = [];
    issue.tags.forEach(nameTag => tags.push(nameTag.name));
    const payload = {
      'event': 'changedTicket',
      'ticketUrl': issue.url,
      'tags': tags,
      'id': issue.id,
      'summary': issue.summary,
      'description': issue.description,
      'projectId': issue.project.key,
      'project': issue.project.name,
      'dateCreate': issue.created,
      'dateUpdate': issue.updated,
      'fields': fields,
    };
    console.log(issue.tags);
    const connection = new http.Connection(albatoHook, null, 2000);
    connection.addHeader('content-type', 'application/json');
    const response = connection.postSync('', null, payload);
    if (!response.isSuccess) {
      console.warn('Failed to post webhook to Albato. Details: ' + response.toString());
    }
  },
});

Important!

Now you have to replace in each rule where you inserted the code, in the very first constant "const albatoHook = '{{albatoHook}}';", the value {{albatoHook}}, with the actual webhook from the previously created connection. Copy the webhook from the connection you created to Albato.

YouTrack (8).png

Insert a webhook into each process you create:

YouTrack (7).png

Next, you need to link your Workflow to the project you need. To do this, go back to your Workflow list, select the Workflow you created and link it to the projects:

YouTrack (9).png

Done! Now you can use the YouTrack in your integrations.


YouTrack

Related articles

Show more
Slack, CRM, and Task Manager Integrations: The Key to a Smooth Workflow
CRM
4 min. read

Slack, CRM, and Task Manager Integrations: The Key to a Smooth Workflow

No more manually creating tasks and notes, and no more wasting valuable time. With the help of automation, you can stay organized and focus on what matters most.

How to set up HubSpot Integrations with 800+ Apps
HubSpot
2 min. read

How to set up HubSpot Integrations with 800+ Apps

Learn how to integrate HubSpot with 800+ apps through Albato. Step-by-step guide to HubSpot integration and connecting your favorite business tools.

How to Connect Printify to Albato
3 min. read

How to Connect Printify to Albato

By connecting Printify and Albato, you can easily set up automations that simplify order processing. Just follow the steps below to set it up.

SaaS Integrations: Benefits, Challenges, and Best Practices
15 min. read

SaaS Integrations: Benefits, Challenges, and Best Practices

In this article, you will learn the essentials of SaaS integrations, including benefits, challenges, approaches, and future trends to optimize your business operations.

How Chatfuel Cut Churn by 25% and Integration Dev Time by 80% with Albato Embedded
Embedded
5 min. read

How Chatfuel Cut Churn by 25% and Integration Dev Time by 80% with Albato Embedded

To overcome its challenges, Chatfuel chose Albato for its embedded white-label integrations, specifically designed for SaaS platforms.

How to Connect Google Contacts to Albato
3 min. read

How to Connect Google Contacts to Albato

By integrating Google Contacts with Albato, you can automate the exchange of key data between teams, partners, and clients. Follow the steps below to set it up.

How to Migrate Your Automations to Albato
2 min. read

How to Migrate Your Automations to Albato

In this post, you will learn how to migrate your automations from any platforms to Albato. Spoiler: we can offer a seamless, stress-free transition with no extra costs.

Best Jotform Alternatives in 2025
9 min. read

Best Jotform Alternatives in 2025

In this article, we compare top Jotform alternatives like Typeform, Google Forms, and Zoho Forms with pricing, features, and pros/cons.

How to Connect Approveit to Albato
3 min. read

How to Connect Approveit to Albato

By connecting Approveit with Albato, you can easily automate the exchange of information between teams, partners, and clients. Follow the steps below to integrate this app into your workflow.

How to Connect Quickbase to Albato
3 min. read

How to Connect Quickbase to Albato

By connecting Quickbase with Albato, you can streamline operations and automate repetitive tasks with ease. Just follow these steps to integrate Quickbase into your workflow.

How to Connect Pennylane to Albato
3 min. read

How to Connect Pennylane to Albato

With Pennylane and Albato, you can easily automate routine tasks and keep your finances under control. Just follow these steps to integrate Pennylane into your workflow.

How to Connect FormCan to Albato
3 min. read

How to Connect FormCan to Albato

By connecting FormCam to Albato, you can streamline data flows from form submissions to your favorite business apps.