Actions89
- Direct API Actions
- CRM Actions
- Task Actions
- User Actions
- SPA Actions
- Activity Actions
- Automation Actions
- Document Generator Actions
- Data Storage Actions
- Chat Actions
Overview
The node enables interaction with Bitrix24's Smart Process Automation (SPA) feature, specifically allowing users to create new SPA items. This is useful for automating business processes within Bitrix24 by programmatically adding entries to custom SPA types.
Typical use cases include:
- Automatically creating SPA records when certain triggers occur in other systems.
- Integrating external data sources with Bitrix24 SPA to keep process data up-to-date.
- Streamlining workflows by programmatically managing SPA items without manual input.
For example, a user could create a new SPA item representing a customer request or an internal task whenever a form is submitted on their website.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating with Bitrix24: OAuth2, Webhook URL, or API Key. |
| Type ID | The specific Smart Process type to create the item in. |
| Fields | A collection of fields to set on the new SPA item. Each field has a name (selected from available SPA fields) and a value to assign. Multiple fields can be added. |
| Use JSON Format for Fields | Whether to provide the fields as a JSON object instead of individual key-value pairs. |
| Fields (JSON) | The fields specified as a JSON object, used if "Use JSON Format for Fields" is enabled. |
Output
The node outputs an array of items where each item's json property contains the response from Bitrix24 after creating the SPA item. This typically includes details about the newly created item such as its ID and any other metadata returned by the Bitrix24 API.
If an error occurs and the node is configured to continue on failure, the output will contain an error object with the error message, resource name, and timestamp.
The node does not output binary data.
Dependencies
- Requires access to a Bitrix24 account with appropriate permissions to create SPA items.
- Requires authentication credentials configured in n8n, supporting OAuth2, webhook URL, or API key methods.
- Relies on Bitrix24 API endpoints for SPA types and SPA item creation.
- Uses internal helper functions to make standardized API calls to Bitrix24.
Troubleshooting
Common issues:
- Incorrect or missing authentication credentials will cause API call failures.
- Selecting an invalid or unavailable SPA Type ID will result in errors or no fields being loaded.
- Providing malformed JSON in the "Fields (JSON)" property will cause parsing errors.
- Required fields not provided may cause the API to reject the creation request.
Error messages:
- Errors from Bitrix24 API calls are propagated and include messages describing the failure.
- If the node is set to continue on fail, errors are returned in the output JSON with details.
Resolutions:
- Verify that authentication credentials are correctly set up and valid.
- Ensure the selected SPA Type ID exists and is accessible.
- Validate JSON syntax if using JSON format for fields.
- Provide all required fields as indicated by the SPA type definition.