Bitrix icon

Bitrix

Consume Bitrix24 REST API

Overview

This node integrates with the Bitrix24 REST API to create a new Company record within the CRM system. It supports two authentication methods: OAuth2 and Webhook, allowing flexible connection setups depending on user preference or environment constraints.

Typical use cases include automating company data entry from external sources, syncing customer databases, or enriching CRM records during workflows. For example, when a new lead is qualified in another system, this node can automatically create a corresponding company profile in Bitrix24, ensuring consistent and up-to-date CRM data without manual input.

Properties

Name Meaning
Authentication Method used to authenticate with Bitrix24 API. Options: OAuth2, Webhook
Input Type How to provide the company data for creation. Options: Using Fields (fill individual fields), Using JSON (provide raw JSON data)
Fields When using "Using Fields" input type, specify one or more field name-value pairs to set on the new company record. Field names are selectable from Bitrix24 entity fields.
JSON Body When using "Using JSON" input type, provide the complete company data as raw JSON to send to the API.

Output

The node outputs the response from the Bitrix24 API after attempting to create the company. The json output typically contains details of the newly created company record, such as its unique ID and any other metadata returned by the API.

If the operation succeeds, the output confirms the creation with relevant data; if it fails, error information will be included in the output JSON.

No binary data output is produced by this node.

Dependencies

  • Requires valid Bitrix24 API credentials configured in n8n, either via OAuth2 or Webhook authentication.
  • Network access to Bitrix24 REST API endpoints.
  • Proper permissions in Bitrix24 to create company records.

Troubleshooting

  • Authentication errors: Ensure that the selected authentication method is correctly configured with valid credentials and tokens.
  • Invalid field names or values: When using the "Using Fields" input type, verify that field names correspond exactly to Bitrix24 CRM company fields. Incorrect or unsupported fields may cause API errors.
  • Malformed JSON: If using the "Using JSON" input type, ensure the JSON body is well-formed and matches the expected structure for creating a company in Bitrix24.
  • API permission issues: Confirm that the authenticated user has sufficient rights to create companies in the Bitrix24 instance.
  • Network connectivity: Check internet connection and firewall settings that might block access to Bitrix24 API endpoints.

Common error messages usually originate from the Bitrix24 API and will be passed through in the node's output. Review these messages carefully to adjust input data or authentication accordingly.

Links and References

Discussion