Bitrix24 icon

Bitrix24

Работа с Bitrix24 API

Overview

This node integrates with the Bitrix24 CRM system to manage Contact records. Specifically, the "Create" operation allows users to create new Contact entries by specifying custom fields and their values. This is useful in scenarios where you want to automate adding new contacts from other systems or workflows, such as importing leads from a web form or syncing contacts from another database.

For example, you could use this node to automatically add a new contact with specified details like name, email, and phone number whenever a new customer signs up on your website.

Properties

Name Meaning
Fields A collection of fields to set on the new Contact record. Each field has:
- Field Name: The specific Contact field to set (loaded dynamically from Bitrix24).
- Field Value: The value to assign to that field.

The "Fields" property supports multiple entries, allowing you to specify many fields for the new Contact.

Output

The node outputs an array of JSON objects, each representing the response from Bitrix24 API for the created Contact(s). Typically, this includes information about the newly created Contact record, such as its unique ID and status.

No binary data output is produced by this node.

Dependencies

  • Requires a valid Bitrix24 API authentication token configured in n8n credentials.
  • The node uses the Bitrix24 webhook URL from the credentials to send HTTP POST requests to Bitrix24's REST API endpoints.
  • The node depends on the axios HTTP client library for making API calls.

Troubleshooting

  • Missing Credentials or Webhook URL: The node will throw errors if the Bitrix24 API credentials or webhook URL are not provided. Ensure these are correctly set up in n8n.
  • Invalid Field Names or Values: If you specify field names that do not exist or provide invalid values, the Bitrix24 API may reject the request. Use the dynamic "Field Name" options to select valid fields.
  • API Errors: Network issues or API limits can cause failures. The node captures Axios errors and returns error messages in the output if "Continue On Fail" is enabled.
  • Empty or Incorrect Input Data: Make sure input data items are properly structured and that the "Fields" property is populated for each item when creating Contacts.

Links and References

Discussion