Actions31
- Company Actions
- Contact Actions
- Deal Actions
- Item Actions
- Lead Actions
- User Custom Method Actions
Overview
This node integrates with the Bitrix24 REST API to retrieve a single CRM item record by its ID. It is designed for scenarios where you need to fetch detailed information about a specific CRM entity, such as a deal, contact, or custom item type, within Bitrix24. For example, it can be used to pull data for a particular sales deal to display in a dashboard or to trigger workflows based on the details of that item.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating with Bitrix24 API. Options: OAuth2 or Webhook. |
| Entity Type Name or ID | Identifier of the CRM entity type (system or user-defined) to query. You can select from a list or specify an ID via expression. |
| ID | The unique identifier of the CRM record to retrieve. |
| Use Original UF Names | Whether to use the original UF_CRM prefix for custom field names in the response. Useful when working with custom fields in Bitrix24 CRM items. |
Output
The node outputs JSON data representing the requested CRM item record. This includes all standard and custom fields associated with the entity, optionally using original custom field names if enabled. The output structure corresponds directly to the Bitrix24 API response for the given entity type and record ID.
No binary data output is produced by this node.
Dependencies
- Requires valid authentication credentials for Bitrix24, either via OAuth2 or Webhook.
- The node depends on Bitrix24 REST API availability.
- No additional external dependencies are required beyond the configured API credentials.
Troubleshooting
Common issues:
- Invalid or expired authentication tokens will cause authorization errors.
- Providing an incorrect or non-existent entity type ID or record ID will result in "not found" errors.
- Network connectivity problems may prevent successful API calls.
Error messages and resolutions:
- Unauthorized / Authentication failed: Verify that the API credentials are correctly configured and have not expired.
- Record not found: Confirm that the entity type and record ID exist in your Bitrix24 instance.
- API rate limits exceeded: Wait and retry later or check Bitrix24 API usage policies.
Links and References
- Bitrix24 REST API Documentation
- n8n Expressions Documentation (for dynamic property values)