Bitrix icon

Bitrix

Consume Bitrix24 REST API

Overview

This node integrates with the Bitrix24 REST API, specifically allowing users to retrieve information about a company record by its ID. It supports two authentication methods: OAuth2 and Webhook. The "Get" operation for the "Company" resource fetches detailed data of a single company from the Bitrix24 CRM system.

Common scenarios include:

  • Retrieving company details to display or process in workflows.
  • Synchronizing company data between Bitrix24 and other systems.
  • Automating follow-up actions based on company information.

Example use case:

  • A workflow that triggers when a new deal is created, then uses this node to get the associated company's full details for further processing or notifications.

Properties

Name Meaning
Authentication Method used to authenticate with Bitrix24 API. Options: OAuth2, Webhook
ID The unique identifier of the company record to retrieve (required)

Output

The node outputs JSON data representing the company record retrieved from Bitrix24. This typically includes fields such as company name, address, contact details, and any custom fields defined in the Bitrix24 CRM.

If the node supports binary data output (not indicated here), it would represent attachments or files related to the company, but this is not evident from the provided code.

Dependencies

  • Requires an active Bitrix24 account with API access.
  • Needs either OAuth2 credentials or a Webhook URL configured in n8n for authentication.
  • No additional external dependencies are indicated.

Troubleshooting

  • Invalid ID error: If the provided company ID does not exist or is incorrect, the node will fail to retrieve data. Verify the ID is correct.
  • Authentication failures: Ensure the selected authentication method is properly configured with valid credentials or webhook URL.
  • API rate limits: Bitrix24 may impose limits; if exceeded, requests might be throttled or rejected.
  • Network issues: Connectivity problems can cause request failures; check network access to Bitrix24 endpoints.

Links and References

Discussion