# Hubspot

{% hint style="info" %}
Open-source and On-premise editions of Ylem require separate specific configurations for this integration. See [below](#configuring-integration-for-open-source-and-on-premise-versions)
{% endhint %}

**Integration type**: `Write`

Integration with Hubspot allows you to create tickets there in a real-time streaming mode.\
\
Instructions are available in the video or the text below.

{% embed url="<https://youtu.be/BXkJbxm4gbQ>" %}
How to integrate Ylem with Hubspot
{% endembed %}

## How to connect?

<figure><img src="https://3180830455-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD0FT8l3QzMrw546vOdHU%2Fuploads%2Fgit-blob-ffce441064c6a1f7d6bd37dadc3d9b5e14eaef75%2Fhubspot_destination_no_auth.png?alt=media" alt=""><figcaption></figcaption></figure>

So first things first — the authorization.

## Authorize your Hubspot

Go to "[Hubspot Authorizations](https://app.datamin.io/hubspot-authorizations)" and click "Add Hubspot Authorization". You will be redirected to Hubspot's page where you need to give your concern.

<figure><img src="https://3180830455-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD0FT8l3QzMrw546vOdHU%2Fuploads%2Fgit-blob-d0267d6776a82d572ed6e0012995b1cdb634ce30%2Fhubspot_consent_auth.png?alt=media" alt=""><figcaption></figcaption></figure>

Once consent's given, you will be redirected back to our application, where you can change the name of just a freshly connected Hubspot instance of yours.

<figure><img src="https://3180830455-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD0FT8l3QzMrw546vOdHU%2Fuploads%2Fgit-blob-c31dae38de82c5e3b05327427d807405cde8fd3a%2Fhubspot_connected.png?alt=media" alt=""><figcaption></figcaption></figure>

## Configure your new destination

Now, on the page of new Hubspot destination creation, you can choose your just-connected Hubspot. Now the question is, what are those pipeline IDs, pipeline stage ID, and owner ID? These are the internal IDs in your Hubspot. How to find them?

#### Pipeline / stage id

First of all navigate yourself to the configuration of pipelines, by clicking that link on the Tickets page.

<figure><img src="https://3180830455-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD0FT8l3QzMrw546vOdHU%2Fuploads%2Fgit-blob-92ad39a04f29cd026e211f6db3dfd801fa9e2335%2Fhubspot_link_to_edit_pipelines.png?alt=media" alt=""><figcaption></figcaption></figure>

In there you will find a list of your pipelines and corresponding stages. By clicking \</>, it will reveal an ID, that you will need to put in your destination configuration.

#### Owner id

An owner is the one who creates a ticket. E.g, you could create a special account for just Ylem or use any other natural person account. In order to find the owner id, please go to the ticket properties, find a property "Ticket Owner", and click "Edit".\
\
You'll see something like this.

<figure><img src="https://3180830455-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD0FT8l3QzMrw546vOdHU%2Fuploads%2Fgit-blob-366cecced3fbf0b3905d0c5189e12f0c4a7fdc67%2Fhubspot_owner_id.png?alt=media" alt=""><figcaption></figcaption></figure>

You need to copy a value in the red rectangle.

### Example of the configured destination

After you've done all the steps above, your Hubspot configuration in Ylem will look like this. Now you can use it in your pipelines!

<figure><img src="https://3180830455-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD0FT8l3QzMrw546vOdHU%2Fuploads%2Fgit-blob-02a2240952e69b16dc3fba2668685a047fde1f25%2Fhubspot_done.png?alt=media" alt=""><figcaption></figcaption></figure>

## Configuring integration for open-source and on-premise versions

If you don't use the cloud version of Ylem but have it installed on your infrastructure under your domain name, you can choose one of the following two ways how to make this integration work.

### Using Hubspot and OAuth 2.0

It is the same way how it works in our cloud version. You need to create your own Hubspot Application and integrate your Ylem instance with it so that your users will be able to authorize Ylem to access their Hubspot accounts.

Here you can read more about how to manage [OAuth 2.0 authentication with Hubspot](https://developers.hubspot.com/docs/api/oauth-quickstart-guide).

By default you will only need a scope to create tickets:

<figure><img src="https://3180830455-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD0FT8l3QzMrw546vOdHU%2Fuploads%2F8koFu4w9Ka0YpyRPKKpF%2FScreenshot%202024-09-17%20at%2015.31.34.png?alt=media&#x26;token=70099e28-1aba-4c90-ac58-6ad6fe3db634" alt=""><figcaption></figcaption></figure>

As soon as the application is created, you will get OAuth 2.0 `CLIENT_ID` and `CLIENT_SECRET` that must be placed into the `./backend/integrations/.env` file of Ylem together with the redirect URL to your Ylem instance:

```bash
INTEGRATIONS_HUBSPOT_OAUTH_CLIENT_ID=%%REPLACE_IT_WITH_THE_CLIENT_ID_OF_YOUR_APP%%
INTEGRATIONS_HUBSPOT_OAUTH_CLIENT_SECRET=%%REPLACE_IT_WITH_THE_CLIENT_SECRET_OF_YOUR_APP%%
INTEGRATIONS_HUBSPOT_AFTER_AUTHORIZATION_REDIRECT_URL=https://%%REPLACE_IT_WITH_THE_DOMAIN_NAME_OF_YOUR_YLEM_INSTANCE%%/hubspot-authorizations/{uuid}/?justConnected
```

Now you can open **https\://%%YOUR\_YLEM\_DOMAIN\_NAME%%/hubspot-authorizations** and try to authorize Hubspot Integration by clicking on the button "**Add Hubspot authorization**".&#x20;

If configured correctly, the process from this point should work exactly as same as [described above](#authorize-your-hubspot).

### Using API integration, Hubspot API, and Private app access tokens

Another way of creating an integration with Hubspot to be able to create tickets directly from Ylem is using its REST API with Private app access tokens.

#### Step 1. Create your Private app access token

Private app access tokens is a safe alternative to using username and password for authentication with various 3rd-party services like Ylem.

This page contains a detailed explanation of how it can be created:

{% embed url="<https://developers.hubspot.com/docs/api/private-apps>" %}

#### Step 2. Creating API Integration and sending requests to it from Ylem pipelines

As soon as you have your Private app access token configured, you can use it as an Access Token for POST/GET requests to Hubspot API.

Check [Hubspot REST API reference](https://developers.hubspot.com/docs/api/private-apps) and create a Ylem [API Integration](https://docs.ylem.co/integrations/library-of-integrations/apis) with it:

<figure><img src="https://3180830455-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD0FT8l3QzMrw546vOdHU%2Fuploads%2FgRXmKZ0nQoGxBoLiSfeZ%2FScreenshot%202024-09-12%20at%2022.15.22.png?alt=media&#x26;token=892816d1-9056-4eb1-a08c-92e2c9012697" alt=""><figcaption></figcaption></figure>

Now you can call it directly from the Ylem pipelines with the necessary query parameters and headers using the [API\_Call](https://docs.ylem.co/pipelines/tasks-ip/api-call) task.

<figure><img src="https://3180830455-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD0FT8l3QzMrw546vOdHU%2Fuploads%2FMsyeYr42RVvMX1QNmsrJ%2FScreenshot%202024-09-12%20at%2022.15.57.png?alt=media&#x26;token=ba00ce83-ebbe-49c1-b17b-4b5862714352" alt=""><figcaption></figcaption></figure>