---
title: "Node.js Project"
description: "Guide for installing Bitrix24 JS SDK in Node.js applications."
canonical_url: "https://bitrix24.github.io/b24jssdk/docs/getting-started/installation/nodejs"
last_updated: "2026-05-08"
---
# Node.js Project

> Guide for installing Bitrix24 JS SDK in Node.js applications.

> [!WARNING]
> We are still updating this page. Some data may be missing here — we will complete it shortly.

## Add to a Node.js project

> [!NOTE]
> Since version `0.4.0` CommonJs is not supported. Only `ESM` and `UMD`.

Before you begin, make sure you have the latest version of Node.js installed.

> [!NOTE]
> We support version Node.js `^18.0.0 || ^20.0.0 || >=22.0.0`

Then run the following command to install the library:

### Install the Bitrix24 JS SDK package

```bash [pnpm]
pnpm add @bitrix24/b24jssdk
```

```bash [yarn]
yarn add @bitrix24/b24jssdk
```

```bash [npm]
npm install @bitrix24/b24jssdk
```

```bash [bun]
bun add @bitrix24/b24jssdk
```

### Import

Import the library into your project:

```ts
import { LoggerFactory } from '@bitrix24/b24jssdk'
```

### Init

> [!CAUTION]
> The `B24Hook` object is intended **exclusively for use on the server**.
> - A webhook contains a secret access key, which **MUST NOT** be used in client-side code (browser, mobile app).
> - For the client side, use <span>
> `B24Frame`
> </span>

To work with Bitrix24 from a standalone server-side application, use the `B24Hook` object.

```ts
import { B24Hook } from '@bitrix24/b24jssdk'

// 1. Get the webhook URL from Bitrix24:
//    - Go to Bitrix24
//    - Settings → Developers → Webhooks
//    - Create a new webhook with the required permissions
//    - Copy the URL in the format: https://your-domain.bitrix24.com/rest/1/your-token/

// 2. Initialize B24Hook
const $b24 = B24Hook.fromWebhookUrl('https://your-domain.bitrix24.com/rest/1/your-token/')

// 3. Use API methods
```

> [!CAUTION]
> The `B24OAuth` object is intended **exclusively for use on the server**.
> - A b24OAuth contains a secret access key, which **MUST NOT** be used in client-side code (browser, mobile app).
> - For the client side, use <span>
> `B24Frame`
> </span>

To work with Bitrix24 from a standalone server-side application, use the `B24OAuth` object.

```ts
import { B24OAuth } from '@bitrix24/b24jssdk'

// 1. Register an application in Bitrix24:
//    - Go to Bitrix24
//    - Settings → Developers → Applications
//    - Create a new application
//    - Get the Client ID and Client Secret

// 2. Initialize B24OAuth
const $b24 = B24OAuth.fromConfig({
  domain: 'your-domain.bitrix24.com',
  clientId: 'your_client_id',
  clientSecret: 'your_client_secret',
  accessToken: 'current_access_token',
  refreshToken: 'refresh_token'
})

// 3. Use API methods

// B24OAuth automatically refreshes tokens when they expire
```

## Sitemap

See the full [sitemap](/b24jssdk/sitemap.md) for all pages.