Bitrix24 icon

Bitrix24

Work with Bitrix24 API

Actions25

Overview

This node integrates with the Bitrix24 CRM API to create new records for a specified resource. The "Create" operation allows users to add entries such as leads, deals, contacts, or companies into their Bitrix24 account by submitting field data either through a form interface or as raw JSON.

Common scenarios where this node is beneficial include:

  • Automating lead capture from web forms or other sources directly into Bitrix24.
  • Creating new contact or company records based on external data feeds.
  • Adding deals programmatically when certain business conditions are met in workflows.

Practical example:

  • A marketing automation workflow collects user sign-up information and uses this node to create a new lead in Bitrix24 with the submitted details.
  • An integration that receives customer support requests can create new contact records with phone and email fields populated.

Properties

Name Meaning
Input Format Method of providing field data:
- Form: Use structured form inputs for each field.
- JSON: Provide all fields as a JSON object string.
Fields (JSON) When using JSON input format, this property accepts a JSON string representing the fields and their values to set on the created record.
Fields When using Form input format, this is a collection of fields to set on the record. Each field includes:
- Field Name: The name of the field to set.
- Communication Type (for contact resource phone/email fields): Type of contact data (e.g., Work, Mobile).
- Field Value: The value to assign to the field. This can be a string or an enumeration depending on the field type.

Output

The node outputs an array of JSON objects corresponding to the responses from the Bitrix24 API for each item processed. For the "Create" operation, each output object contains the result of the creation request, typically including the ID of the newly created record and any additional metadata returned by Bitrix24.

No binary data output is produced by this node.

Example output structure snippet:

[
  {
    "result": {
      "ID": "12345"
    }
  }
]

Dependencies

  • Requires an active Bitrix24 API connection configured with a valid webhook URL and authentication credentials.
  • The node uses HTTP POST requests to Bitrix24's REST API endpoints.
  • No additional external services beyond Bitrix24 are required.

Troubleshooting

  • Missing Credentials or Webhook URL: The node will throw errors if the API credentials or webhook URL are not provided or invalid. Ensure these are correctly configured in n8n.
  • Invalid Field Names or Values: If fields do not match Bitrix24's expected schema or contain invalid values, the API may reject the request. Verify field names and types against Bitrix24 documentation.
  • JSON Parsing Errors: When using JSON input format, malformed JSON strings will cause parsing failures. Validate JSON syntax before execution.
  • API Response Errors: Network issues or Bitrix24 service errors may cause failed requests. Check error messages returned in the output for clues.
  • Rate Limits: Bitrix24 may impose rate limits; excessive requests could be throttled or rejected.

Links and References

Discussion