@bitrix24/mcp-docs 0.1.0

package/dist/data/methods.json

@@ -0,0 +1,370 @@
+[
+    {
+        "method": "crm.deal.list",
+        "description": "Returns a paginated list of CRM deals matching the given filter. Supports filtering by any deal field, field selection, sorting, and pagination via start parameter.",
+        "scope": "crm",
+        "parameters": [
+            { "name": "filter", "type": "object", "description": "Filter object. Keys are field names (prefix with > for greater-than, < for less-than). Example: { '>OPPORTUNITY': 1000, 'STAGE_ID': 'WON' }" },
+            { "name": "select", "type": "array", "description": "Array of field names to return. Omit to return all fields. Example: ['ID', 'TITLE', 'OPPORTUNITY', 'STAGE_ID']" },
+            { "name": "order", "type": "object", "description": "Sort order. Keys are field names, values are 'ASC' or 'DESC'. Example: { 'DATE_CREATE': 'DESC' }" },
+            { "name": "start", "type": "number", "description": "Pagination offset. Use the 'next' value from the previous response. Default: 0" }
+        ],
+        "returns": "Object with 'result' array of deal objects and 'total' count. Each deal contains ID, TITLE, OPPORTUNITY, CURRENCY_ID, STAGE_ID, ASSIGNED_BY_ID, DATE_CREATE, etc.",
+        "example": "BX24.callMethod('crm.deal.list', { filter: { '>OPPORTUNITY': 1000, 'ASSIGNED_BY_ID': 1 }, select: ['ID', 'TITLE', 'OPPORTUNITY', 'STAGE_ID'], order: { 'DATE_CREATE': 'DESC' }, start: 0 })"
+    },
+    {
+        "method": "crm.deal.get",
+        "description": "Returns full details of a single CRM deal by its ID, including all standard and custom fields.",
+        "scope": "crm",
+        "parameters": [
+            { "name": "id", "type": "number", "description": "ID of the deal to retrieve" }
+        ],
+        "returns": "Object with 'result' containing a single deal object with all fields including custom UF_ fields.",
+        "example": "BX24.callMethod('crm.deal.get', { id: 123 })"
+    },
+    {
+        "method": "crm.deal.add",
+        "description": "Creates a new CRM deal with the provided field values. Returns the ID of the newly created deal.",
+        "scope": "crm",
+        "parameters": [
+            { "name": "fields", "type": "object", "description": "Object of field name-value pairs for the new deal. Required: TITLE. Common: OPPORTUNITY, CURRENCY_ID, STAGE_ID, CONTACT_ID, COMPANY_ID, ASSIGNED_BY_ID" }
+        ],
+        "returns": "Object with 'result' containing the integer ID of the newly created deal.",
+        "example": "BX24.callMethod('crm.deal.add', { fields: { TITLE: 'New Deal', OPPORTUNITY: 50000, CURRENCY_ID: 'USD', STAGE_ID: 'NEW', ASSIGNED_BY_ID: 1 } })"
+    },
+    {
+        "method": "crm.deal.update",
+        "description": "Updates field values on an existing CRM deal. Only provided fields are changed; omitted fields retain their current values.",
+        "scope": "crm",
+        "parameters": [
+            { "name": "id", "type": "number", "description": "ID of the deal to update" },
+            { "name": "fields", "type": "object", "description": "Object of field name-value pairs to update on the deal" }
+        ],
+        "returns": "Object with 'result' = true on success.",
+        "example": "BX24.callMethod('crm.deal.update', { id: 123, fields: { STAGE_ID: 'WON', OPPORTUNITY: 75000 } })"
+    },
+    {
+        "method": "crm.deal.delete",
+        "description": "Permanently deletes a CRM deal by its ID. This action is irreversible.",
+        "scope": "crm",
+        "parameters": [
+            { "name": "id", "type": "number", "description": "ID of the deal to delete" }
+        ],
+        "returns": "Object with 'result' = true on success.",
+        "example": "BX24.callMethod('crm.deal.delete', { id: 123 })"
+    },
+    {
+        "method": "crm.lead.list",
+        "description": "Returns a paginated list of CRM leads matching the given filter. Supports filtering, field selection, sorting, and pagination.",
+        "scope": "crm",
+        "parameters": [
+            { "name": "filter", "type": "object", "description": "Filter object for lead fields. Example: { 'STATUS_ID': 'NEW', '>DATE_CREATE': '2024-01-01' }" },
+            { "name": "select", "type": "array", "description": "Array of field names to return. Example: ['ID', 'TITLE', 'NAME', 'LAST_NAME', 'STATUS_ID', 'ASSIGNED_BY_ID']" },
+            { "name": "order", "type": "object", "description": "Sort order object. Example: { 'DATE_CREATE': 'DESC' }" },
+            { "name": "start", "type": "number", "description": "Pagination offset." }
+        ],
+        "returns": "Object with 'result' array of lead objects and 'total' count.",
+        "example": "BX24.callMethod('crm.lead.list', { filter: { 'STATUS_ID': 'NEW' }, select: ['ID', 'TITLE', 'NAME', 'LAST_NAME', 'PHONE'], order: { 'DATE_CREATE': 'DESC' } })"
+    },
+    {
+        "method": "crm.lead.add",
+        "description": "Creates a new CRM lead with the provided field values.",
+        "scope": "crm",
+        "parameters": [
+            { "name": "fields", "type": "object", "description": "Object of field name-value pairs. Required: TITLE (or NAME/LAST_NAME). Common: PHONE, EMAIL, STATUS_ID, SOURCE_ID, ASSIGNED_BY_ID" }
+        ],
+        "returns": "Object with 'result' containing the integer ID of the newly created lead.",
+        "example": "BX24.callMethod('crm.lead.add', { fields: { TITLE: 'New Lead', NAME: 'John', LAST_NAME: 'Doe', PHONE: [{ VALUE: '+1234567890', VALUE_TYPE: 'WORK' }], STATUS_ID: 'NEW' } })"
+    },
+    {
+        "method": "crm.contact.list",
+        "description": "Returns a paginated list of CRM contacts matching the given filter.",
+        "scope": "crm",
+        "parameters": [
+            { "name": "filter", "type": "object", "description": "Filter object for contact fields. Example: { 'COMPANY_ID': 456 }" },
+            { "name": "select", "type": "array", "description": "Array of field names to return." },
+            { "name": "order", "type": "object", "description": "Sort order object." },
+            { "name": "start", "type": "number", "description": "Pagination offset." }
+        ],
+        "returns": "Object with 'result' array of contact objects and 'total' count.",
+        "example": "BX24.callMethod('crm.contact.list', { filter: { 'COMPANY_ID': 456 }, select: ['ID', 'NAME', 'LAST_NAME', 'PHONE', 'EMAIL'] })"
+    },
+    {
+        "method": "crm.contact.add",
+        "description": "Creates a new CRM contact with the provided field values.",
+        "scope": "crm",
+        "parameters": [
+            { "name": "fields", "type": "object", "description": "Object of field name-value pairs. Common: NAME, LAST_NAME, PHONE, EMAIL, COMPANY_ID, ASSIGNED_BY_ID" }
+        ],
+        "returns": "Object with 'result' containing the integer ID of the newly created contact.",
+        "example": "BX24.callMethod('crm.contact.add', { fields: { NAME: 'Jane', LAST_NAME: 'Smith', EMAIL: [{ VALUE: 'jane@example.com', VALUE_TYPE: 'WORK' }], COMPANY_ID: 456 } })"
+    },
+    {
+        "method": "crm.company.list",
+        "description": "Returns a paginated list of CRM companies matching the given filter.",
+        "scope": "crm",
+        "parameters": [
+            { "name": "filter", "type": "object", "description": "Filter object for company fields. Example: { '%TITLE': 'Acme' }" },
+            { "name": "select", "type": "array", "description": "Array of field names to return." },
+            { "name": "order", "type": "object", "description": "Sort order object." },
+            { "name": "start", "type": "number", "description": "Pagination offset." }
+        ],
+        "returns": "Object with 'result' array of company objects and 'total' count.",
+        "example": "BX24.callMethod('crm.company.list', { filter: { '%TITLE': 'Acme' }, select: ['ID', 'TITLE', 'PHONE', 'EMAIL', 'INDUSTRY'] })"
+    },
+    {
+        "method": "crm.company.add",
+        "description": "Creates a new CRM company with the provided field values.",
+        "scope": "crm",
+        "parameters": [
+            { "name": "fields", "type": "object", "description": "Object of field name-value pairs. Required: TITLE. Common: PHONE, EMAIL, INDUSTRY, ASSIGNED_BY_ID" }
+        ],
+        "returns": "Object with 'result' containing the integer ID of the newly created company.",
+        "example": "BX24.callMethod('crm.company.add', { fields: { TITLE: 'Acme Corp', INDUSTRY: 'IT', PHONE: [{ VALUE: '+1234567890', VALUE_TYPE: 'WORK' }] } })"
+    },
+    {
+        "method": "crm.deal.fields",
+        "description": "Returns the list of all available fields for the CRM Deal entity, including standard fields and custom UF_ fields with their types, captions, and attributes.",
+        "scope": "crm",
+        "parameters": [],
+        "returns": "Object with 'result' containing a map of field codes to field descriptor objects including type, title, isRequired, isReadOnly, isMultiple.",
+        "example": "BX24.callMethod('crm.deal.fields')"
+    },
+    {
+        "method": "tasks.task.list",
+        "description": "Returns a paginated list of tasks visible to the current user, with filtering, field selection, and sorting support.",
+        "scope": "task",
+        "parameters": [
+            { "name": "filter", "type": "object", "description": "Filter object. Supports fields like RESPONSIBLE_ID, GROUP_ID, STATUS, DEADLINE. Example: { 'RESPONSIBLE_ID': 1, 'STATUS': 2 }" },
+            { "name": "select", "type": "array", "description": "Array of field names. Example: ['ID', 'TITLE', 'DESCRIPTION', 'STATUS', 'RESPONSIBLE_ID', 'DEADLINE']" },
+            { "name": "order", "type": "object", "description": "Sort order. Example: { 'DEADLINE': 'ASC' }" },
+            { "name": "start", "type": "number", "description": "Pagination offset." }
+        ],
+        "returns": "Object with 'result.tasks' array of task objects and 'result.total' count.",
+        "example": "BX24.callMethod('tasks.task.list', { filter: { 'RESPONSIBLE_ID': 1, '!STATUS': 5 }, select: ['ID', 'TITLE', 'STATUS', 'DEADLINE'], order: { 'DEADLINE': 'ASC' } })"
+    },
+    {
+        "method": "tasks.task.get",
+        "description": "Returns full details of a single task by its ID.",
+        "scope": "task",
+        "parameters": [
+            { "name": "taskId", "type": "number", "description": "ID of the task to retrieve" },
+            { "name": "select", "type": "array", "description": "Optional array of field names to return" }
+        ],
+        "returns": "Object with 'result.task' containing the task data including all fields.",
+        "example": "BX24.callMethod('tasks.task.get', { taskId: 42 })"
+    },
+    {
+        "method": "tasks.task.add",
+        "description": "Creates a new task with the provided field values.",
+        "scope": "task",
+        "parameters": [
+            { "name": "fields", "type": "object", "description": "Task fields. Required: TITLE. Common: DESCRIPTION, RESPONSIBLE_ID, DEADLINE, GROUP_ID, PARENT_ID, PRIORITY" }
+        ],
+        "returns": "Object with 'result.task' containing the newly created task with its assigned ID.",
+        "example": "BX24.callMethod('tasks.task.add', { fields: { TITLE: 'Prepare report', RESPONSIBLE_ID: 5, DEADLINE: '2024-12-31T18:00:00+03:00', PRIORITY: 2 } })"
+    },
+    {
+        "method": "tasks.task.update",
+        "description": "Updates field values on an existing task. Only provided fields are changed.",
+        "scope": "task",
+        "parameters": [
+            { "name": "taskId", "type": "number", "description": "ID of the task to update" },
+            { "name": "fields", "type": "object", "description": "Object of field name-value pairs to update" }
+        ],
+        "returns": "Object with 'result' = true on success.",
+        "example": "BX24.callMethod('tasks.task.update', { taskId: 42, fields: { STATUS: 5, DEADLINE: '2024-12-15T18:00:00+03:00' } })"
+    },
+    {
+        "method": "tasks.task.complete",
+        "description": "Marks a task as completed.",
+        "scope": "task",
+        "parameters": [
+            { "name": "taskId", "type": "number", "description": "ID of the task to complete" }
+        ],
+        "returns": "Object with 'result' = true on success.",
+        "example": "BX24.callMethod('tasks.task.complete', { taskId: 42 })"
+    },
+    {
+        "method": "im.message.add",
+        "description": "Sends a message to a Bitrix24 chat or to a specific user. Supports text, system messages, and rich content attachments.",
+        "scope": "im",
+        "parameters": [
+            { "name": "DIALOG_ID", "type": "string", "description": "Target dialog ID. Use 'userId' format (e.g. '1') for private messages or chat ID for group chats." },
+            { "name": "MESSAGE", "type": "string", "description": "Text content of the message. Supports BBCode formatting." },
+            { "name": "SYSTEM", "type": "string", "description": "Set to 'Y' to send as a system notification (no sender name displayed). Default: 'N'" },
+            { "name": "ATTACH", "type": "object", "description": "Optional rich attachment object with blocks (image, link, table, etc.)" }
+        ],
+        "returns": "Object with 'result' containing the integer ID of the sent message.",
+        "example": "BX24.callMethod('im.message.add', { DIALOG_ID: '1', MESSAGE: 'Hello! Your deal has been updated.', SYSTEM: 'N' })"
+    },
+    {
+        "method": "im.chat.get",
+        "description": "Returns information about a specific chat by its ID.",
+        "scope": "im",
+        "parameters": [
+            { "name": "CHAT_ID", "type": "number", "description": "ID of the chat to retrieve" }
+        ],
+        "returns": "Object with 'result' containing chat details: name, type, owner, member count, etc.",
+        "example": "BX24.callMethod('im.chat.get', { CHAT_ID: 100 })"
+    },
+    {
+        "method": "im.chat.add",
+        "description": "Creates a new group chat with the specified members.",
+        "scope": "im",
+        "parameters": [
+            { "name": "TITLE", "type": "string", "description": "Chat name" },
+            { "name": "USERS", "type": "array", "description": "Array of user IDs to add to the chat" },
+            { "name": "TYPE", "type": "string", "description": "Chat type: 'CHAT' for group chat, 'OPEN' for open channel. Default: 'CHAT'" }
+        ],
+        "returns": "Object with 'result.CHAT_ID' containing the ID of the newly created chat.",
+        "example": "BX24.callMethod('im.chat.add', { TITLE: 'Project Alpha', USERS: [1, 5, 12], TYPE: 'CHAT' })"
+    },
+    {
+        "method": "disk.folder.uploadfile",
+        "description": "Uploads a file to a specified folder in Bitrix24 Drive.",
+        "scope": "disk",
+        "parameters": [
+            { "name": "id", "type": "number", "description": "ID of the target folder in Bitrix24 Drive" },
+            { "name": "data", "type": "object", "description": "File data object with 'NAME' (filename) and 'CONTENT' (base64-encoded file content)" },
+            { "name": "rights", "type": "array", "description": "Optional access rights for the uploaded file" }
+        ],
+        "returns": "Object with 'result' containing the created file object with ID, NAME, SIZE, DOWNLOAD_URL, etc.",
+        "example": "BX24.callMethod('disk.folder.uploadfile', { id: 10, data: { NAME: 'report.pdf', CONTENT: '<base64 content>' } })"
+    },
+    {
+        "method": "disk.folder.getchildren",
+        "description": "Returns the list of files and subfolders within a specified folder.",
+        "scope": "disk",
+        "parameters": [
+            { "name": "id", "type": "number", "description": "ID of the folder to list" },
+            { "name": "filter", "type": "object", "description": "Optional filter. Example: { 'TYPE': 'file' }" },
+            { "name": "start", "type": "number", "description": "Pagination offset." }
+        ],
+        "returns": "Object with 'result' array of file and folder objects with their metadata.",
+        "example": "BX24.callMethod('disk.folder.getchildren', { id: 10 })"
+    },
+    {
+        "method": "disk.file.get",
+        "description": "Returns metadata and download URL for a specific file in Bitrix24 Drive.",
+        "scope": "disk",
+        "parameters": [
+            { "name": "id", "type": "number", "description": "ID of the file to retrieve" }
+        ],
+        "returns": "Object with 'result' containing file metadata: NAME, SIZE, MIME_TYPE, DOWNLOAD_URL, CREATE_TIME, UPDATE_TIME, etc.",
+        "example": "BX24.callMethod('disk.file.get', { id: 250 })"
+    },
+    {
+        "method": "disk.file.delete",
+        "description": "Moves a file to the Bitrix24 Drive trash (does not permanently delete).",
+        "scope": "disk",
+        "parameters": [
+            { "name": "id", "type": "number", "description": "ID of the file to move to trash" }
+        ],
+        "returns": "Object with 'result' = true on success.",
+        "example": "BX24.callMethod('disk.file.delete', { id: 250 })"
+    },
+    {
+        "method": "disk.storage.getlist",
+        "description": "Returns the list of storages (drives) available to the current application or user.",
+        "scope": "disk",
+        "parameters": [],
+        "returns": "Object with 'result' array of storage objects with ID, NAME, MODULE_ID, ENTITY_TYPE, ROOT_OBJECT_ID.",
+        "example": "BX24.callMethod('disk.storage.getlist')"
+    },
+    {
+        "method": "user.get",
+        "description": "Returns a list of users matching the given filter. Commonly used to search for users by name, email, or department.",
+        "scope": "user",
+        "parameters": [
+            { "name": "FILTER", "type": "object", "description": "Filter object. Supports: ID, NAME, LAST_NAME, EMAIL, DEPARTMENT_ID, USER_TYPE. Example: { 'DEPARTMENT_ID': 3, 'ACTIVE': true }" },
+            { "name": "SELECT", "type": "array", "description": "Array of field names to return. Example: ['ID', 'NAME', 'LAST_NAME', 'EMAIL', 'PERSONAL_PHOTO']" },
+            { "name": "START", "type": "number", "description": "Pagination offset." }
+        ],
+        "returns": "Object with 'result' array of user objects with all requested fields.",
+        "example": "BX24.callMethod('user.get', { FILTER: { 'DEPARTMENT_ID': 3, 'ACTIVE': true }, SELECT: ['ID', 'NAME', 'LAST_NAME', 'EMAIL', 'WORK_POSITION'] })"
+    },
+    {
+        "method": "user.current",
+        "description": "Returns the profile of the currently authenticated user (the user whose access token is being used). Useful for identifying who is interacting with your application.",
+        "scope": "user_basic",
+        "parameters": [],
+        "returns": "Object with 'result' containing the current user's profile: ID, NAME, LAST_NAME, EMAIL, PERSONAL_PHOTO, WORK_POSITION, IS_ADMIN, etc.",
+        "example": "BX24.callMethod('user.current')"
+    },
+    {
+        "method": "user.update",
+        "description": "Updates profile fields for a specified user.",
+        "scope": "user",
+        "parameters": [
+            { "name": "ID", "type": "number", "description": "ID of the user to update" },
+            { "name": "FIELDS", "type": "object", "description": "Object of field name-value pairs to update. Example: { 'WORK_POSITION': 'Senior Developer' }" }
+        ],
+        "returns": "Object with 'result' = true on success.",
+        "example": "BX24.callMethod('user.update', { ID: 5, FIELDS: { WORK_POSITION: 'Senior Developer', WORK_PHONE: '+1234567890' } })"
+    },
+    {
+        "method": "placement.bind",
+        "description": "Registers an application handler URL for a specific Bitrix24 UI placement. This is how applications add custom buttons, tabs, and menu items to the Bitrix24 interface.",
+        "scope": "placement",
+        "parameters": [
+            { "name": "PLACEMENT", "type": "string", "description": "The placement code to bind to. Example: 'CRM_DEAL_DETAIL_TAB'" },
+            { "name": "HANDLER", "type": "string", "description": "The full HTTPS URL of your handler that will be loaded in the placement" },
+            { "name": "TITLE", "type": "string", "description": "Display title for the placement (button label, tab name, menu item text)" },
+            { "name": "DESCRIPTION", "type": "string", "description": "Optional description of the placement" },
+            { "name": "OPTIONS", "type": "object", "description": "Optional placement-specific options. For tabs: { label: 'Tab Name' }" }
+        ],
+        "returns": "Object with 'result' = true on success.",
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'CRM_DEAL_DETAIL_TAB', HANDLER: 'https://myapp.example.com/deal-tab', TITLE: 'Integration', OPTIONS: { label: 'My Integration' } })"
+    },
+    {
+        "method": "placement.list",
+        "description": "Returns all placements currently bound by the current application.",
+        "scope": "placement",
+        "parameters": [],
+        "returns": "Object with 'result' array of bound placement objects with PLACEMENT, HANDLER, TITLE, and OPTIONS.",
+        "example": "BX24.callMethod('placement.list')"
+    },
+    {
+        "method": "placement.unbind",
+        "description": "Removes a previously registered handler for a specific placement.",
+        "scope": "placement",
+        "parameters": [
+            { "name": "PLACEMENT", "type": "string", "description": "The placement code to unbind" },
+            { "name": "HANDLER", "type": "string", "description": "The handler URL to remove" }
+        ],
+        "returns": "Object with 'result' containing the count of removed bindings.",
+        "example": "BX24.callMethod('placement.unbind', { PLACEMENT: 'CRM_DEAL_DETAIL_TAB', HANDLER: 'https://myapp.example.com/deal-tab' })"
+    },
+    {
+        "method": "app.info",
+        "description": "Returns information about the current application installation: application code, scope, portal domain, member ID, and current user details.",
+        "scope": "main",
+        "parameters": [],
+        "returns": "Object with 'result' containing: ID (app code), STATUS, INSTALL, PAYMENT_EXPIRED, DAYS, LICENSE, PORTAL_ADDRESS, MEMBER_ID, USER_ID, IS_ADMIN, PLACED, SCOPE.",
+        "example": "BX24.callMethod('app.info')"
+    },
+    {
+        "method": "event.bind",
+        "description": "Subscribes the application to a Bitrix24 server event. When the event occurs, Bitrix24 will send an HTTP POST to the handler URL.",
+        "scope": "main",
+        "parameters": [
+            { "name": "EVENT", "type": "string", "description": "Event name to subscribe to. Example: 'ONCRMDEALADD', 'ONCRMDEALUPDATE'" },
+            { "name": "HANDLER", "type": "string", "description": "Full HTTPS URL that will receive event notifications" },
+            { "name": "AUTH_TYPE", "type": "number", "description": "User ID to use for auth token sent with events. Default: 0 (application token)" }
+        ],
+        "returns": "Object with 'result' = true on success.",
+        "example": "BX24.callMethod('event.bind', { EVENT: 'ONCRMDEALADD', HANDLER: 'https://myapp.example.com/webhook/deal-added' })"
+    },
+    {
+        "method": "event.unbind",
+        "description": "Removes a previously registered event subscription.",
+        "scope": "main",
+        "parameters": [
+            { "name": "EVENT", "type": "string", "description": "Event name to unsubscribe from" },
+            { "name": "HANDLER", "type": "string", "description": "Handler URL to remove" }
+        ],
+        "returns": "Object with 'result' = true on success.",
+        "example": "BX24.callMethod('event.unbind', { EVENT: 'ONCRMDEALADD', HANDLER: 'https://myapp.example.com/webhook/deal-added' })"
+    }
+]

package/dist/data/placements.json

@@ -0,0 +1,252 @@
+[
+    {
+        "code": "CRM_LEAD_LIST_MENU",
+        "title": "Lead list context menu",
+        "description": "Adds a custom menu item to the context menu in the CRM Leads list. The handler is called when the user right-clicks or opens the action menu on a lead row.",
+        "module": "crm",
+        "group": "CRM Lists",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: CRM_LEAD_LIST_MENU" },
+            { "name": "ID", "type": "number", "description": "ID of the lead" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'CRM_LEAD_LIST_MENU', HANDLER: 'https://myapp.example.com/handler', TITLE: 'My Action' })"
+    },
+    {
+        "code": "CRM_CONTACT_LIST_MENU",
+        "title": "Contact list context menu",
+        "description": "Adds a custom menu item to the context menu in the CRM Contacts list. The handler is called when the user opens the action menu on a contact row.",
+        "module": "crm",
+        "group": "CRM Lists",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: CRM_CONTACT_LIST_MENU" },
+            { "name": "ID", "type": "number", "description": "ID of the contact" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'CRM_CONTACT_LIST_MENU', HANDLER: 'https://myapp.example.com/handler', TITLE: 'My Action' })"
+    },
+    {
+        "code": "CRM_COMPANY_LIST_MENU",
+        "title": "Company list context menu",
+        "description": "Adds a custom menu item to the context menu in the CRM Companies list. The handler is called when the user opens the action menu on a company row.",
+        "module": "crm",
+        "group": "CRM Lists",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: CRM_COMPANY_LIST_MENU" },
+            { "name": "ID", "type": "number", "description": "ID of the company" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'CRM_COMPANY_LIST_MENU', HANDLER: 'https://myapp.example.com/handler', TITLE: 'My Action' })"
+    },
+    {
+        "code": "CRM_DEAL_LIST_MENU",
+        "title": "Deal list context menu",
+        "description": "Adds a custom menu item to the context menu in the CRM Deals list. The handler is called when the user opens the action menu on a deal row.",
+        "module": "crm",
+        "group": "CRM Lists",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: CRM_DEAL_LIST_MENU" },
+            { "name": "ID", "type": "number", "description": "ID of the deal" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'CRM_DEAL_LIST_MENU', HANDLER: 'https://myapp.example.com/handler', TITLE: 'My Action' })"
+    },
+    {
+        "code": "CRM_QUOTE_LIST_MENU",
+        "title": "Quote list context menu",
+        "description": "Adds a custom menu item to the context menu in the CRM Quotes (Estimates) list. The handler is called when the user opens the action menu on a quote row.",
+        "module": "crm",
+        "group": "CRM Lists",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: CRM_QUOTE_LIST_MENU" },
+            { "name": "ID", "type": "number", "description": "ID of the quote" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'CRM_QUOTE_LIST_MENU', HANDLER: 'https://myapp.example.com/handler', TITLE: 'My Action' })"
+    },
+    {
+        "code": "CRM_SMART_INVOICE_LIST_MENU",
+        "title": "Smart invoice list context menu",
+        "description": "Adds a custom menu item to the context menu in the CRM Smart Invoices list. The handler is called when the user opens the action menu on a smart invoice row.",
+        "module": "crm",
+        "group": "CRM Lists",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: CRM_SMART_INVOICE_LIST_MENU" },
+            { "name": "ID", "type": "number", "description": "ID of the smart invoice" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'CRM_SMART_INVOICE_LIST_MENU', HANDLER: 'https://myapp.example.com/handler', TITLE: 'My Action' })"
+    },
+    {
+        "code": "CRM_LEAD_DETAIL_TAB",
+        "title": "Lead detail tab",
+        "description": "Embeds a custom tab (iframe) into the CRM Lead detail page. Your application is displayed inside the tab when the user opens a lead record. Useful for showing related data, third-party integrations, or custom widgets alongside the lead.",
+        "module": "crm",
+        "group": "CRM Detail Tabs",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: CRM_LEAD_DETAIL_TAB" },
+            { "name": "ID", "type": "number", "description": "ID of the lead being viewed" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'CRM_LEAD_DETAIL_TAB', HANDLER: 'https://myapp.example.com/tab', TITLE: 'My Tab', OPTIONS: { label: 'My Tab' } })"
+    },
+    {
+        "code": "CRM_DEAL_DETAIL_TAB",
+        "title": "Deal detail tab",
+        "description": "Embeds a custom tab (iframe) into the CRM Deal detail page. Your application is displayed inside the tab when the user opens a deal record. Useful for showing related data, external documents, or custom analytics alongside the deal.",
+        "module": "crm",
+        "group": "CRM Detail Tabs",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: CRM_DEAL_DETAIL_TAB" },
+            { "name": "ID", "type": "number", "description": "ID of the deal being viewed" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'CRM_DEAL_DETAIL_TAB', HANDLER: 'https://myapp.example.com/tab', TITLE: 'My Tab', OPTIONS: { label: 'My Tab' } })"
+    },
+    {
+        "code": "CRM_CONTACT_DETAIL_TAB",
+        "title": "Contact detail tab",
+        "description": "Embeds a custom tab (iframe) into the CRM Contact detail page. Your application is displayed inside the tab when the user opens a contact record.",
+        "module": "crm",
+        "group": "CRM Detail Tabs",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: CRM_CONTACT_DETAIL_TAB" },
+            { "name": "ID", "type": "number", "description": "ID of the contact being viewed" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'CRM_CONTACT_DETAIL_TAB', HANDLER: 'https://myapp.example.com/tab', TITLE: 'My Tab', OPTIONS: { label: 'My Tab' } })"
+    },
+    {
+        "code": "CRM_COMPANY_DETAIL_TAB",
+        "title": "Company detail tab",
+        "description": "Embeds a custom tab (iframe) into the CRM Company detail page. Your application is displayed inside the tab when the user opens a company record.",
+        "module": "crm",
+        "group": "CRM Detail Tabs",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: CRM_COMPANY_DETAIL_TAB" },
+            { "name": "ID", "type": "number", "description": "ID of the company being viewed" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'CRM_COMPANY_DETAIL_TAB', HANDLER: 'https://myapp.example.com/tab', TITLE: 'My Tab', OPTIONS: { label: 'My Tab' } })"
+    },
+    {
+        "code": "CRM_QUOTE_DETAIL_TAB",
+        "title": "Quote detail tab",
+        "description": "Embeds a custom tab (iframe) into the CRM Quote (Estimate) detail page. Your application is displayed inside the tab when the user opens a quote record.",
+        "module": "crm",
+        "group": "CRM Detail Tabs",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: CRM_QUOTE_DETAIL_TAB" },
+            { "name": "ID", "type": "number", "description": "ID of the quote being viewed" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'CRM_QUOTE_DETAIL_TAB', HANDLER: 'https://myapp.example.com/tab', TITLE: 'My Tab', OPTIONS: { label: 'My Tab' } })"
+    },
+    {
+        "code": "CRM_SMART_INVOICE_DETAIL_TAB",
+        "title": "Smart invoice detail tab",
+        "description": "Embeds a custom tab (iframe) into the CRM Smart Invoice detail page. Your application is displayed inside the tab when the user opens a smart invoice record.",
+        "module": "crm",
+        "group": "CRM Detail Tabs",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: CRM_SMART_INVOICE_DETAIL_TAB" },
+            { "name": "ID", "type": "number", "description": "ID of the smart invoice being viewed" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'CRM_SMART_INVOICE_DETAIL_TAB', HANDLER: 'https://myapp.example.com/tab', TITLE: 'My Tab', OPTIONS: { label: 'My Tab' } })"
+    },
+    {
+        "code": "CRM_LEAD_DETAIL_ACTIVITY",
+        "title": "Lead detail activity",
+        "description": "Adds a custom activity button in the CRM Lead detail page activity section. Allows applications to create custom activity types visible in the lead timeline and activity block.",
+        "module": "crm",
+        "group": "CRM Detail Activity",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: CRM_LEAD_DETAIL_ACTIVITY" },
+            { "name": "ID", "type": "number", "description": "ID of the lead" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'CRM_LEAD_DETAIL_ACTIVITY', HANDLER: 'https://myapp.example.com/activity', TITLE: 'My Activity' })"
+    },
+    {
+        "code": "CRM_DEAL_DETAIL_ACTIVITY",
+        "title": "Deal detail activity",
+        "description": "Adds a custom activity button in the CRM Deal detail page activity section. Allows applications to create custom activity types visible in the deal timeline and activity block.",
+        "module": "crm",
+        "group": "CRM Detail Activity",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: CRM_DEAL_DETAIL_ACTIVITY" },
+            { "name": "ID", "type": "number", "description": "ID of the deal" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'CRM_DEAL_DETAIL_ACTIVITY', HANDLER: 'https://myapp.example.com/activity', TITLE: 'My Activity' })"
+    },
+    {
+        "code": "CRM_CONTACT_DETAIL_ACTIVITY",
+        "title": "Contact detail activity",
+        "description": "Adds a custom activity button in the CRM Contact detail page activity section. Allows applications to create custom activity types visible in the contact timeline and activity block.",
+        "module": "crm",
+        "group": "CRM Detail Activity",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: CRM_CONTACT_DETAIL_ACTIVITY" },
+            { "name": "ID", "type": "number", "description": "ID of the contact" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'CRM_CONTACT_DETAIL_ACTIVITY', HANDLER: 'https://myapp.example.com/activity', TITLE: 'My Activity' })"
+    },
+    {
+        "code": "CRM_COMPANY_DETAIL_ACTIVITY",
+        "title": "Company detail activity",
+        "description": "Adds a custom activity button in the CRM Company detail page activity section. Allows applications to create custom activity types visible in the company timeline and activity block.",
+        "module": "crm",
+        "group": "CRM Detail Activity",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: CRM_COMPANY_DETAIL_ACTIVITY" },
+            { "name": "ID", "type": "number", "description": "ID of the company" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'CRM_COMPANY_DETAIL_ACTIVITY', HANDLER: 'https://myapp.example.com/activity', TITLE: 'My Activity' })"
+    },
+    {
+        "code": "TASK_LIST_CONTEXT_MENU",
+        "title": "Task list context menu",
+        "description": "Adds a custom menu item to the context menu in the Tasks list. The handler is called when the user right-clicks or opens the action menu on a task row. Useful for adding task-related actions from external systems.",
+        "module": "tasks",
+        "group": "Tasks",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: TASK_LIST_CONTEXT_MENU" },
+            { "name": "ID", "type": "number", "description": "ID of the task" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'TASK_LIST_CONTEXT_MENU', HANDLER: 'https://myapp.example.com/task-action', TITLE: 'Export Task' })"
+    },
+    {
+        "code": "USER_PROFILE_MENU",
+        "title": "User profile menu",
+        "description": "Adds a custom menu item to the user profile action menu. The handler is called when the user opens the menu on any user profile page. Useful for profile-related integrations like HR systems.",
+        "module": "user",
+        "group": "User Profile",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: USER_PROFILE_MENU" },
+            { "name": "USER_ID", "type": "number", "description": "ID of the user whose profile is being viewed" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'USER_PROFILE_MENU', HANDLER: 'https://myapp.example.com/user-action', TITLE: 'View HR Profile' })"
+    },
+    {
+        "code": "USER_PROFILE_TOOLBAR",
+        "title": "User profile toolbar",
+        "description": "Adds a custom button to the toolbar on user profile pages. The handler is called when the user clicks the button on any user profile. Useful for quick actions related to a user from external HR or directory systems.",
+        "module": "user",
+        "group": "User Profile",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: USER_PROFILE_TOOLBAR" },
+            { "name": "USER_ID", "type": "number", "description": "ID of the user whose profile is being viewed" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'USER_PROFILE_TOOLBAR', HANDLER: 'https://myapp.example.com/user-toolbar', TITLE: 'My Action' })"
+    },
+    {
+        "code": "REST_APP_URI",
+        "title": "Application main page (universal)",
+        "description": "The primary entry point for an application embedded inside Bitrix24. The application is displayed as a full-page iframe accessible from the left navigation menu or from the app catalogue. This is the most common placement for general-purpose applications.",
+        "module": "main",
+        "group": "Universal",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: REST_APP_URI" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'REST_APP_URI', HANDLER: 'https://myapp.example.com/', TITLE: 'My App' })"
+    },
+    {
+        "code": "PAGE_BACKGROUND_WORKER",
+        "title": "Page background worker",
+        "description": "A hidden background iframe that runs on every Bitrix24 page. Useful for applications that need to listen to events, run periodic checks, or react to user navigation without being visible. The handler URL is loaded invisibly in the background.",
+        "module": "main",
+        "group": "Universal",
+        "handler_params": [
+            { "name": "PLACEMENT", "type": "string", "description": "Placement code: PAGE_BACKGROUND_WORKER" }
+        ],
+        "example": "BX24.callMethod('placement.bind', { PLACEMENT: 'PAGE_BACKGROUND_WORKER', HANDLER: 'https://myapp.example.com/worker' })"
+    }
+]