---
title: Bitrix24 connector
description: Connect a Bitrix24 CRM account to TSync — inbound webhook or OAuth, with an encrypted, testable connection.
product: TSync Intelligence 11.3.6
language: en
canonical: https://docs.tsync.pro/modules/tsync-bitrix24/
source: https://docs.tsync.pro/llms.txt
---

# Bitrix24 connector

TSync can connect to **Bitrix24** so its CRM data can flow into your TSync platform — the second CRM connector
alongside amoCRM. This first version sets up and **tests the connection**; importing leads and live sync arrive in
the next versions.

## Turn it on

A new connector ships **deactivated and inert** — it does nothing until you activate and enable it.

1. Go to **Configuration Center → Module Management Center** and **activate** the *Bitrix24* module.
2. Open **Integrations → Bitrix24** and click **Enable connector** (while it is off, no data is touched).

## Add a connection

On **Bitrix24 → Settings**, click into the form and choose how to authenticate:

- **Inbound webhook (simplest).** In Bitrix24, create an *inbound webhook* (Developer resources → Other → Inbound
  webhook) with CRM access, and copy its URL (it looks like `https://yourco.bitrix24.com/rest/1/abcd…/`). Paste it
  into **Inbound webhook URL**. No app registration needed.
- **OAuth 2.0 app.** If you have a Bitrix24 local/marketplace app, enter the **portal domain**, **client ID** and
  **client secret**, then use **Connect (OAuth)**. The redirect URI to register in your Bitrix24 app is shown on the
  form.

Type a name, fill the fields, and **Save connection**. Your credentials are **encrypted** before they are stored.

## Test it

After saving, click **Test connection**. TSync calls Bitrix24 and shows whether it connected (and the profile name)
or what went wrong. The connection's status and the time of the last test are kept on the list.

## What's kept private

All secrets — the webhook URL and the OAuth client secret — are stored **encrypted**. The connection logs never
contain your tokens or secrets in clear text.

## Who can see it

The connector registers four permissions — **view**, **create**, **edit** and **delete** — under *Bitrix24* in
**Setup → Roles**. A staff member needs at least **view** for the menu entry to appear at all; saving a
connection needs **create/edit**, and removing one needs **delete**.

The sidebar entry appears as soon as the module is active and the person has **view** — it does not wait for the
connector to be switched on, so you can find the page in order to turn it on.

## Reference data, and why there is nothing to refresh

The CRM mapping console reads your Bitrix24 **deal categories** (pipelines), **deal stages**, **users** and
**deal custom fields**, so you can line them up with their TSync counterparts.

These are fetched **live from Bitrix24 every time they are read** — this connector keeps no local copy. So if
you press *Refresh reference data* you are told there was nothing to bring up to date: you were already looking
at the current values. Rename a stage in Bitrix24 and it is correct on your next page load.

## The log

**Bitrix24 → Logs** records what the connector did — each connection test, each OAuth exchange, and each failure
with the reason Bitrix24 gave. It is the first place to look when a connection that used to work stops working,
because it separates *"your credentials were rejected"* from *"Bitrix24 did not answer"*.

Tokens and secrets are **never** written to the log in clear text.

## More than one company

If you run **multi-company**, every connection, token and log entry is anchored to the company it was created
under. One company's Bitrix24 connection is not visible to, and cannot be used by, another.

## What this connector does today

Plainly, because the section below has said "coming soon" for a while:

| | |
|---|---|
| Connect to Bitrix24 (webhook or OAuth) | ✅ |
| Test the connection and see why it failed | ✅ |
| Read pipelines, stages, users and custom fields for mapping | ✅ |
| Per-company isolation, encrypted credentials, activity log | ✅ |
| **Import your Bitrix24 leads into TSync** | ❌ not yet |
| **Two-way or scheduled synchronisation** | ❌ not yet |

If you need to bring existing CRM records across today, **amoCRM** is the connector with a working importer.
## What's next

This version is **connection management + test**. The upcoming versions add field/pipeline mapping, importing your
Bitrix24 leads into TSync (matched so the same lead is never created twice), and keeping things in sync — the same
way the amoCRM connector grew.