Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform
Join our community

Actions290

Overview

This node integrates with the Bitrix24 platform, specifically allowing interaction with its CRM and business resources. The "Data Storage" resource with the "Get Entity Item" operation enables users to retrieve a specific item from a given entity within Bitrix24. This is useful when you want to fetch detailed information about a particular record, such as a contact, deal, lead, or any custom entity item stored in Bitrix24.

Practical examples include:

  • Fetching a contact's details by their unique ID to use in further automation.
  • Retrieving a deal's information before updating or processing it.
  • Accessing a custom entity item for reporting or integration purposes.

Properties

Name Meaning
Authentication Method of authenticating with Bitrix24: OAuth2 (recommended), Webhook (simpler), or API Key.
Entity ID The unique identifier of the entity from which to get the item (e.g., contact, deal).
Item ID The unique identifier of the specific item within the entity to retrieve.

Output

The node outputs an array of items where each item's json property contains the data of the requested entity item fetched from Bitrix24. The structure corresponds directly to the fields and values of the entity item in Bitrix24.

If an error occurs and "Continue On Fail" is enabled, the output will contain an object with an error message, the resource name, and a timestamp.

No binary data output is indicated for this operation.

Dependencies

  • Requires authentication credentials configured in n8n for Bitrix24 using one of the supported methods: OAuth2, Webhook URL, or API Key.
  • Relies on Bitrix24 API endpoints to fetch entity data.
  • No additional external dependencies beyond standard HTTP requests to Bitrix24 APIs.

Troubleshooting

  • Common Issues:

    • Invalid or expired authentication credentials can cause authorization failures.
    • Incorrect Entity ID or Item ID will result in errors or empty responses.
    • Network connectivity issues may prevent API calls from succeeding.

  • Error Messages:

    • Errors thrown during execution will include the message from the Bitrix24 API or internal node errors.
    • If "Continue On Fail" is enabled, errors are returned in the output JSON with an error field describing the issue.

  • Resolution Tips:

    • Verify that the authentication method and credentials are correctly set up and valid.
    • Double-check the Entity ID and Item ID values for correctness.
    • Ensure the Bitrix24 instance is accessible and the API limits are not exceeded.

Links and References

Discussion