SkillFoxx

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

  • 0 ★ on the repository
  • Last commit
  • MIT
Skill

Minimal access

Why this level

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

svjszn/bitrix24-api-skillAuthor:soajv

Install

Services

Manual install

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.

Access and checks

How we review

Minimal accessThe tool runs nothing and makes no network calls.

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

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.

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.

Discussion

No questions or reviews yet.

All Bitrix24 tools
Russian stack

A Bitrix24 REST skill split into capability packs with a method allowlist, risk confirmations and an audit log

SkillBroad access26
Russian stack

Four skills for Bitrix24 apps: install and OAuth, a batching REST client, events and iframe placements, CRM business processes and calendar

SkillExtended access
Russian stack

A skill for administering, diagnosing and developing boxed Bitrix24 and Bitrix Framework, built from official documentation

SkillExtended access1

The @bitrix24/b24jssdk skill set

@bitrix24/b24jssdk skills

Official

Seven official Bitrix24 skills for the JS/TS SDK: picking B24Hook, B24Frame or B24OAuth, REST calls, filters, iframe managers and 12 ready mini-apps

SkillExtended access18
Official

A skill for Bitrix24's official PHP SDK that teaches an agent to wire up webhooks and OAuth, call SDK services, and handle results, errors and pagination

SkillExtended access103

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.

README badge

Original 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.

Report a problem