bitrix24

name	bitrix24
description	Bitrix24 (Битрикс24) — CRM, tasks, calendar, drive, chat via REST API. Управление порталом Битрикс24: сделки, контакты, лиды, задачи, календарь, диск, мессенджер. Install Bitrix24 skill to connect your portal.

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

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]=[phone]
fields[PHONE][0][VALUE_TYPE]=WORK
fields[EMAIL][0][VALUE]=[e-mail]
fields[EMAIL][0][VALUE_TYPE]=WORK

Batch Requests

Combine up to 50 calls in one request:

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