bitrix_skill

Overview

This skill provides direct access to the Bitrix24 REST API via curl to manage CRM records, tasks, and users from a shell environment. It uses an incoming webhook URL for authentication so you can create, update, list, and delete leads, contacts, deals, tasks, and query user data. Examples and patterns are included for safe, repeatable automation in scripts.

How this skill works

Set your incoming webhook URL in an environment variable and call Bitrix24 methods by issuing HTTP GET or POST requests with curl. Complex queries (filters, select, order) are sent as JSON payloads to the method endpoints, and responses return JSON objects you can parse with jq or other tools. Use provided endpoints to retrieve field definitions, respect pagination, and handle rate limits for bulk operations.

When to use it

• Automating lead intake and syncing external form submissions into Bitrix24 CRM
• Updating deal stages and opportunities from sales systems or scripts
• Creating and assigning tasks programmatically from external workflows
• Exporting or auditing user and contact lists for reporting
• Running bulk updates or filtered queries against CRM entities

Best practices

• Store the webhook URL in an environment variable and never commit it to source control
• Use POST with a JSON body for filters, select, and complex queries to avoid URL length limits
• Call *.fields.json methods to discover valid field names before sending updates
• Respect Bitrix24 rate limits: add small delays or batching for bulk operations
• Handle pagination with the start parameter when expecting large result sets

Example use cases

• Create a new lead from a contact form and attach phone/email fields in one API call
• List active deals and update their stage to WON after external payment confirmation
• Generate tasks for onboarding new clients and assign responsible users automatically
• Fetch current user info and user lists to build internal dashboards or sync directories
• Retrieve CRM field definitions to validate payloads before sending updates