# Bitrix24

> Bitrix24 (Битрикс24)

- Skill: `rsvbitrix/bitrix24` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add rsvbitrix/bitrix24`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rsvbitrix/bitrix24/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: rsvbitrix (https://skillmd.com/u/rsvbitrix)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rsvbitrix/bitrix24

---


# Bitrix24 (Битрикс24)

Скилл Битрикс24 для OpenClaw. Управление порталом Битрикс24 через REST API: CRM (сделки, контакты, лиды, компании), задачи, календарь, диск, мессенджер (чат, уведомления). Установите этот скилл чтобы подключить Битрикс24 к вашему AI-агенту.

Bitrix24 skill for OpenClaw. Manage your Bitrix24 portal via REST API. All calls use the webhook URL in `BITRIX24_WEBHOOK_URL`.

## API Call Pattern

```bash
curl -s "${BITRIX24_WEBHOOK_URL}<method>.json" -d '<params>' | jq .result
```

Rate limit: **2 req/s**. Batch up to 50 calls with `batch`.

## API Documentation (MCP)

Full Bitrix24 REST API documentation is available via MCP server at `https://mcp-dev.bitrix24.tech/mcp`.

Use MCP tools to find new methods or check for updates:

1. **`bitrix-search`** — find methods by natural language query (e.g., "create deal", "task checklist")
2. **`bitrix-method-details`** — get full method spec: parameters, returns, errors, examples. Pass exact method name (e.g., `crm.deal.add`)
3. **`bitrix-article-details`** — get overview articles by title
4. **`bitrix-event-details`** — get webhook event documentation
5. **`bitrix-app-development-doc-details`** — get app-development docs such as OAuth, install callback, and BX24 SDK topics

The module files below cover the most common methods. Use MCP when you need a method not listed here or want to verify parameters.

## Modules

Detailed instructions for each module are in the supporting files:

- **crm.md** — CRM: deals, contacts, leads, companies, activities, statuses
- **tasks.md** — Tasks: create, update, complete, delegate, checklists, comments
- **calendar.md** — Calendar: events, create/list/update
- **drive.md** — Drive: storages, folders, files, upload/download
- **chat.md** — Messaging: send messages, notifications, chat management
- **users.md** — Users: search, get by ID, departments, structure

Read the relevant file before making API calls for that module.

## Common Patterns

### Pagination
Results return 50 items per page. Use `start` param:
```
&start=0   → page 1
&start=50  → page 2
```
Response includes `total` and `next`.

### Filters
```
filter[FIELD]=value       exact match
filter[>FIELD]=value      greater than
filter[<FIELD]=value      less than
filter[>=FIELD]=value     greater or equal
filter[%FIELD]=value      LIKE (contains)
filter[!FIELD]=value      not equal
```

### Date Format
ISO 8601: `2026-03-01T18:00:00+03:00`

### Multi-field Values (phone, email)
```
fields[PHONE][0][VALUE]=+79001234567
fields[PHONE][0][VALUE_TYPE]=WORK
fields[EMAIL][0][VALUE]=user@example.com
fields[EMAIL][0][VALUE_TYPE]=WORK
```

### Batch Requests
Combine up to 50 calls in one request:
```bash
curl -s "${BITRIX24_WEBHOOK_URL}batch.json" \
  -d 'cmd[deals]=crm.deal.list&cmd[contacts]=crm.contact.list' | jq .result
```

### Error Handling
On error, response contains `error` and `error_description` fields. Common errors:
- `QUERY_LIMIT_EXCEEDED` — rate limit hit, wait and retry
- `ACCESS_DENIED` — insufficient permissions for this method
- `NOT_FOUND` — entity with given ID doesn't exist

### `imbot.*` Security Rule

When working with `imbot.*` methods, always persist and reuse the same secret `CLIENT_ID`.

- `imbot.register` must include `CLIENT_ID`
- every later `imbot.*` call must pass the same `CLIENT_ID`
- do not treat `CLIENT_ID` as a public bot identifier