# Create your Bitrix24 connection

{% hint style="info" %}
**Oauth connection:** The first step is to install GearPlug in your Bitrix24 account so that GearPlug may access the data.
{% endhint %}

### Install GearPlug in your Bitrix24 account

To create a new Plug for Bitrix24, you must install our app to your Bitrix24 account.

1. **Go to the Bitrix24’s Marketplace** via the left-side menu Applications → Market.

<figure><img src="https://lh3.googleusercontent.com/T9UffBMR-REpwMvlNb0AGQW9de_4jrYjaY1JXji6OnavGnWhRWP6IBayXOnVTB7BrTWaDfksZbbDxgAxqWooJt3M_pg66wv23E6r6VUUyE--VKVV8j-wJCP0PkVe3UWUruhkis92_uuVkZ_b4C-suQ" alt=""><figcaption></figcaption></figure>

2. **Type “GearPlug” on the search bar** to find the app.

<figure><img src="https://lh3.googleusercontent.com/PoJut-PLJ9q5zYA7WRj0ViTExN7xrl-qpFsi_ub7qFBuRbeLyz8mVjcVo8iccQGul9hNw5QoCLsU_HPpXGHnXWhnpzYEWV6PyWoSZUssEmyseYPx8_Yt-hlbs26O1rkoyWOisZGtXFWY7wU9Fw_tNg" alt=""><figcaption></figcaption></figure>

3. On the app’s page, **click “Install.”**

<figure><img src="https://lh5.googleusercontent.com/x68qGvwXFlByA0QkxBC0NE-1lm-I-T-5jA3FeTQ2NKFde9u4v_xZLSoSfWcGXrlCGu4QtEJkYZjZID82P9xVZR3uaaZcv5nWyOrD1zYquY0C9dbmd-LG18sTao6tS7u797bE-QK8i5tSi6WLxgZTOw" alt=""><figcaption></figcaption></figure>

4. **Click “Install” on the pop-up screen**, after reading all terms and policies. Check the permissions required as well.

<figure><img src="https://lh3.googleusercontent.com/kYVQqlCkqN7by9gbRyuk99WYjwi0GNu0zMwhmhLpOset5NZqQGTHk33MdDyMT0mmQxtQeOrbCXreD9ooEVG_Ldye24ppxcEtGUHx60PCbv7xYE0tMezLqs6pRjx02bBurTUTSvUVgnLoqCAkf3uICA" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
If you don’t install GearPlug in Bitrix24 before setting up your Plug, we won’t be able to connect to your app. When you try to create the connection, it won’t work.
{% endhint %}

### Create your Bitrix24 Plug on GearPlug

With GearPlug installed, head over to your Apps menu on GearPlug and set up the Plug.

1. **Choose Bitrix24 in the “New connection”** drop-down menu in “My Apps.” Click “Create.”

<figure><img src="https://lh3.googleusercontent.com/UmC9cZF864EnKq9Y6svKwuliyQOv9WkzvJWBfZUhto6AGb1-fp9LmVgpSSkO5Cgj_2FNtX2mFgWcsvz6ucUjdevH95YkGMIJqMvMuUWG3bsxjGO00Qz0I3MVUjFTIOC0E-sdmDjzjJoDX4lIXt96ZA" alt=""><figcaption></figcaption></figure>

2. **Enter your app’s domain** into the “Domain” field. The domain is the URL you’ll find in your browser.

<figure><img src="https://lh4.googleusercontent.com/OHTlJdm5ntuGD9SuBz3M_YxYCuwrJnjdUQSX-cBOgp1ea2E3phvzfEhXTqb6wHEI_MpvyGAKHPiCP0UHhaDuU5z9-CijshgKx-Rr1fLqg--j2on4_M8Cw2Zkkg0xoM4LqBwTj-ywx-fjEZVxR5bRzA" alt=""><figcaption></figcaption></figure>

3. **Click “Continue.”** By the end, your field should look like this.

<figure><img src="https://lh3.googleusercontent.com/uKT-bu2B-kWmUdA9AnUW3NbkYqy65GFUW9ZOC3ch9MweQ4aTyWUSSx3xVkoAq29hsToNaWDOO-Ahzs5t43guVt1n4Q3AUTqP7bt1m93FqaCZUpY-Tctj8oHVfJbyqf4aNbI6qAl_SHyd_Ajx7j6PWg" alt=""><figcaption></figcaption></figure>

Once connected, you’ll get a message confirming the integration’s success. You may now close the pop-up; your app is ready to use.

<figure><img src="https://lh6.googleusercontent.com/Q0EfIwF7LqLph1zQyXaYkSED7cUZ4MIvOAfYhWluJxx-laQutblSpiM_Hag7x-J3P1y0ce9QXhswp7HOdpzNdQkis8smoNcQEu8UqAnNYkykzNc4H3d6ALIqpLjiy5tddl7vXmtOkc9LZudgGXV-zw" alt=""><figcaption></figcaption></figure>


---

# 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.gearplug.io/english/set-up-your-integrations/bitrix24/create-your-bitrix24-connection.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.