SkillFoxx

Type a name, a task or a service

Bitrix24 REST API skill

bitrix24-rest-api

A Claude Code skill with real-portal-verified Bitrix24 REST API gotchas: auth modes, errors hidden under HTTP 200, retries and rate limits

Skill

Low risk

We rate an entry low when it mostly gives the agent instructions and reference material.

Why this level

  • Only reference knowledge for the agent; the skill itself makes no requests
All reasons and checks
Russian stack

soajv/bitrix24-api-skillAuthor:soajv

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/bitrix24-rest-api

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Run in a terminal in the project folder

npx skills add soajv/bitrix24-api-skill --skill bitrix24-rest-api -a claude-code -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 0ae5aa0
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .claude/skills
cp -R "$tmp/skills/bitrix24-rest-api" .claude/skills/bitrix24-rest-api

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add soajv/bitrix24-api-skill --skill bitrix24-rest-api -a cursor -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 0ae5aa0
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-rest-api" .agents/skills/bitrix24-rest-api

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add soajv/bitrix24-api-skill --skill bitrix24-rest-api -a github-copilot -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 0ae5aa0
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .github/skills
cp -R "$tmp/skills/bitrix24-rest-api" .github/skills/bitrix24-rest-api

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add soajv/bitrix24-api-skill --skill bitrix24-rest-api -a codex -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 0ae5aa0
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-rest-api" .agents/skills/bitrix24-rest-api

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add soajv/bitrix24-api-skill --skill bitrix24-rest-api -a gemini-cli -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 0ae5aa0
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-rest-api" .agents/skills/bitrix24-rest-api

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .devin/skills
cp -R "$tmp/skills/bitrix24-rest-api" .devin/skills/bitrix24-rest-api

Commands for macOS and Linux, on Windows run them in Git Bash.

Formerly Windsurf.

Run in a terminal in the project folder

npx skills add soajv/bitrix24-api-skill --skill bitrix24-rest-api -a cline -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 0ae5aa0
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .cline/skills
cp -R "$tmp/skills/bitrix24-rest-api" .cline/skills/bitrix24-rest-api

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add soajv/bitrix24-api-skill --skill bitrix24-rest-api -a roo -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 0ae5aa0
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .roo/skills
cp -R "$tmp/skills/bitrix24-rest-api" .roo/skills/bitrix24-rest-api

Commands for macOS and Linux, on Windows run them in Git Bash.

A fork of Roo Code, same .roo folders.

Run in a terminal in the project folder

npx skills add soajv/bitrix24-api-skill --skill bitrix24-rest-api -a opencode -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 0ae5aa0
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-rest-api" .agents/skills/bitrix24-rest-api

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-rest-api" .agents/skills/bitrix24-rest-api

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/soajv/bitrix24-api-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-rest-api/
git -C "$tmp" checkout 0ae5aa0ec700db323080ecc14f6527c3197d691d
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-rest-api" .agents/skills/bitrix24-rest-api

Commands for macOS and Linux, on Windows run them in Git Bash.

You will need: Node.js

Checked against the repository on Sep 25, 2026, commit 0ae5aa0.

Text for your agent

Copy or symlink the skills/bitrix24-rest-api folder from soajv/bitrix24-api-skill into your Claude Code skills directory and load it before writing or debugging a Bitrix24 integration.

Other ways from the author
git clone https://github.com/soajv/bitrix24-api-skill.git && cp -r bitrix24-api-skill/skills/bitrix24-rest-api ~/.claude/skills/

Copy the skill folder into your Claude Code skills directory.

This is third-party code. Review the repository files before installing.

What it does

The skill loads a set of verified facts into the agent's context before writing or debugging a Bitrix24 integration: the difference between an inbound webhook and an OAuth app, a warning that an error can arrive with HTTP 200 and must be read from the body, the inconsistent shape of list-method responses, a safe retry policy for network errors and 429/503, and leaky-bucket rate limits. It also covers the ONAPPINSTALL event's nested auth fields and one documented Bitrix quirk where lead auto-conversion silently detaches a deal.

Who it is for. For developers writing or debugging a Bitrix24 REST API integration with the help of an AI agent.

Good fit when

  • You are writing a Bitrix24 REST API client from scratch
  • You are debugging oddities like HTTP 200 with an error body
  • You are setting up retries and rate-limit handling

Not a fit when

  • You want a ready client library rather than reference knowledge
  • You are working with Open Lines and chatbots: there is a separate related skill for that

Example request

Write a Bitrix24 REST API client with retries and proper error checking in the response

Limitations

This is not a code library but a SKILL.md knowledge file for an agent; the repo has no concrete integration examples of its own. The facts are dated September 2026 and may drift if the API changes. There is a single author, no stars, and only the MIT license noted.

How to disable. Delete the skills/bitrix24-rest-api folder from your agent's skills directory.

Security check

  • Only reference knowledge for the agent; the skill itself makes no requests

README in short

The README explains this is not a client library but a knowledge file for an AI agent, and lists what it covers: auth modes, checking the response body for an error even on HTTP 200, inconsistent list shapes, a retry policy, diagnosing insufficient_scope, rate limits, a set of common CRM and task methods, and a related Open Lines skill.

SKILL.md

---
name: bitrix24-rest-api
description: Foundational knowledge for calling the Bitrix24 REST API from a backend service — auth modes (inbound webhook vs OAuth app), the "200 OK with error body" gotcha, list-endpoint response shapes, retry policy, and rate limits. Load this before writing any Bitrix24 API client code.
---

# Bitrix24 REST API — foundations

Source: official docs at apidocs.bitrix24.com (verified Sep 2026) plus empirical testing against a real Bitrix24 portal and a proven client pattern running in production integrations.

## Two ways to authenticate

1. Inbound webhook — https://<portal>.bitrix24.ru/rest/<user>/<token>/<method>.json. A portal admin creates it once, picking which method scopes it can call. No OAuth flow, no token refresh. This is enough for most bot and Open Lines session methods as long as the webhook has the right permissions checked.
2. OAuth local/marketplace app — install flow, token refresh via oauth.bitrix24.tech. Needed for app-level methods not exposed to webhooks, such as the whole imconnector.* family.

FAQ

How does a webhook differ from an OAuth app?

A webhook is simpler and needs no token reinstall, but it cannot reach app-level methods like imconnector.*, which need a local or marketplace app.

Where do the skill's facts come from?

From the official apidocs.bitrix24.com docs plus verification against a real portal, not just the docs.

Editors’ pick

A skills library that gives coding agents a development process: brainstorming, planning, TDD, subagents and code review

PluginMedium riskNo VPN needed292.5K
Editors’ pick

Small composable skills for engineering with agents: plan grilling, TDD, bug diagnosis, code review and architecture

SkillLow risk271.4K
Editors’ pick

GitHub toolkit for spec-driven development: the specify CLI adds agent commands and skills to a project, from principles to implementation

CLIMedium riskNo VPN needed139.3K

Reference MCP servers

Model Context Protocol servers

Official

Official reference MCP servers: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time and Everything

MCP serverMedium risk90.6K
Foxx AIBitrix24 REST API skill

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.