Bitrix icon

Bitrix

Consume Bitrix24 REST API

Overview

This node integrates with the Bitrix24 REST API to perform operations on CRM Leads. Specifically, the "Get" operation retrieves a single Lead record by its unique ID. This is useful when you need to fetch detailed information about a specific lead in your sales pipeline, for example, to display lead details in a dashboard or to use lead data in subsequent workflow steps.

Common scenarios include:

  • Fetching lead details after a form submission.
  • Retrieving lead information to enrich customer profiles.
  • Accessing lead data for reporting or analytics purposes.

Properties

Name Meaning
Authentication Method of authenticating with Bitrix24 API. Options: OAuth2, Webhook
ID The unique identifier of the Lead record to retrieve (required). Example: "12345"

Output

The node outputs JSON data representing the Lead record fetched from Bitrix24. The structure typically includes all standard and custom fields associated with the Lead, such as name, contact info, status, source, and any other CRM-specific attributes.

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

Dependencies

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

Troubleshooting

  • Missing or invalid ID: The node requires a valid Lead ID; ensure the ID is correct and exists in Bitrix24.
  • Authentication errors: Verify that the OAuth2 token or webhook URL is correctly set up and has sufficient permissions.
  • API rate limits or connectivity issues: Network problems or Bitrix24 API limits may cause failures; check connectivity and API usage quotas.
  • Unexpected response structure: If Bitrix24 changes their API, the node might return unexpected data; verify API version compatibility.

Links and References

Discussion