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 Bitrix24 node enables interaction with the Bitrix24 CRM and business platform, specifically supporting operations on various resources including Smart Process Automation (SPA). The "Get Types" operation under the SPA resource fetches a list of available SPA types from Bitrix24. This is useful for workflows that need to dynamically retrieve and work with different SPA entity types, such as automating processes based on specific SPA categories or integrating SPA data into other systems.
Practical examples include:
- Automatically retrieving all SPA types to populate dropdowns in subsequent workflow steps.
- Using SPA type IDs to query or manipulate SPA items in Bitrix24.
- Building dynamic automation flows that adapt based on available SPA types.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating API requests. Options: - OAuth2 (recommended for production) - Webhook (simpler but less secure) - API Key authentication |
| Return All | Boolean flag indicating whether to return all results or limit the number of returned items. |
| Options | Additional optional parameters: - Access Token: Use a specific access token instead of stored credentials. - Filter: JSON filter following Bitrix24 syntax to narrow down results. - Order: JSON specifying result ordering. - Select: Comma-separated list of fields to return; leave empty to return all fields. |
Output
The node outputs an array of objects representing SPA types. Each object typically contains:
name: A user-friendly name combining the SPA type title and its ID.value: The SPA type's unique identifier as a string.description: A description or title of the SPA type.
Example output item structure:
{
"name": "Example SPA Type (ID: 123)",
"value": "123",
"description": "Example SPA Type"
}
This output can be used to dynamically select SPA types in later workflow steps or to drive conditional logic based on SPA type metadata.
Dependencies
- Requires valid authentication credentials for Bitrix24 via one of the supported methods (OAuth2, webhook URL, or API key).
- The node internally calls Bitrix24's API method
"crm.type.list"to retrieve SPA types. - No additional external dependencies beyond Bitrix24 API access are required.
Troubleshooting
Common Issues:
- Authentication failures due to invalid or expired tokens.
- API rate limits or permission restrictions preventing retrieval of SPA types.
- Empty or missing SPA types if the Bitrix24 account has no configured SPA entities.
Error Messages:
- Errors during API calls will be caught and surfaced as error messages in the node output.
- If the API response lacks expected data, the node returns a placeholder option indicating no SPA types found.
Resolutions:
- Verify that the authentication credentials are correct and have sufficient permissions.
- Ensure the Bitrix24 account has SPA types configured.
- Check network connectivity and API endpoint accessibility.
- Use the "Return All" property carefully to avoid large data loads.