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 create a new Contact record in the CRM system. It is useful for automating the addition of contact information into Bitrix24 from various sources, such as form submissions, lead generation tools, or other business applications.
Typical use cases include:
- Automatically adding new customer contacts collected from a website form.
- Syncing contacts from external databases or CRMs into Bitrix24.
- Creating contacts as part of a sales or marketing automation workflow.
The node supports two input methods for creating a contact: specifying individual fields or providing a raw JSON object representing the contact data.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating with Bitrix24 API. Options: OAuth2, Webhook |
| Input Type | How to provide the contact data. Options: Using Fields (fill individual fields), Using JSON (raw JSON data) |
| Fields | When using "Using Fields" input type, specify one or more field name-value pairs for the contact. Field names can be selected from available Bitrix24 contact fields. |
| JSON Body | When using "Using JSON" input type, provide the complete contact data as a JSON object. |
Output
The node outputs the result of the create operation in the json output field. This typically includes the newly created contact's details as returned by the Bitrix24 API, such as the contact ID and any other relevant metadata.
If the node supports binary data output (not indicated here), it would represent attachments or files related to the contact, but this node focuses on JSON data only.
Dependencies
- Requires an active Bitrix24 account with API access.
- Requires authentication credentials configured in n8n, either via OAuth2 or Webhook method.
- The node depends on Bitrix24 REST API availability and permissions granted to the authenticated user.
Troubleshooting
- Authentication errors: Ensure that the provided API credentials are valid and have sufficient permissions to create contacts.
- Field validation errors: If using individual fields, verify that field names and values conform to Bitrix24 requirements. Invalid or missing required fields may cause errors.
- JSON format errors: When using raw JSON input, ensure the JSON structure matches Bitrix24's expected schema for contacts.
- API rate limits: Bitrix24 may impose limits on API calls; excessive requests might result in throttling errors.
- Network issues: Connectivity problems between n8n and Bitrix24 API endpoints can cause failures.
Links and References
- Bitrix24 REST API Documentation
- n8n Expressions Documentation (for dynamic field value expressions)