Overview
This node integrates with the Cubo Suite CRM API to manage deals within the CRM system. Specifically, the "Deal - Create" operation allows users to create new deals by providing relevant deal information such as title, associated person, pipeline, price, and other optional details.
Common scenarios where this node is beneficial include:
- Automating the creation of sales deals when a lead reaches a certain stage in a marketing funnel.
- Integrating external lead capture forms or systems to automatically push new deals into Cubo Suite CRM.
- Synchronizing deals from other platforms or databases into Cubo Suite CRM for unified sales tracking.
Practical example:
- When a new customer inquiry is received via a web form, this node can be used to create a corresponding deal in Cubo Suite CRM with the customer's name, contact details, deal value, and assigned sales user.
Properties
| Name | Meaning |
|---|---|
| Title | Title of the deal (required) |
| People Name | Name of the person associated with the deal (required) |
| Pipe ID | ID of the pipeline where the deal belongs (must be a positive number, required) |
| Price | Price or value of the deal |
| User ID | ID of the user responsible for the deal (included only if greater than 0) |
| People Phone | Phone number of the person associated with the deal |
| Organization Name | Name of the organization related to the deal |
| Stage ID | ID of the stage in the pipeline (included only if greater than 0) |
| Rating | Numeric rating of the deal |
| Products | Collection of products linked to the deal; each product includes: |
| - Product ID | |
| - Quantity | |
| - Price | |
| Custom Fields | Collection of custom fields to add additional data; each custom field includes: |
| - Custom Field ID | |
| - Value |
Output
The node outputs an array of JSON objects representing the created deal(s). Each object contains the response data returned by the Cubo Suite CRM API after successfully creating a deal. This typically includes identifiers, status, and any metadata about the newly created deal.
The node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the Cubo Suite CRM API.
- The base URL for API requests is
https://api.cubosuite.com.br. - Proper configuration of the API authentication credential in n8n is necessary.
Troubleshooting
Common issues:
- Missing required fields such as "Title", "People Name", or "Pipe ID" will cause the API request to fail.
- Providing invalid IDs (e.g., negative numbers or zero where positive numbers are expected) may result in errors.
- Network connectivity issues or incorrect API credentials will prevent successful communication with the Cubo Suite CRM API.
Error messages:
- Authentication errors indicate invalid or missing API credentials; verify and update the API key credential.
- Validation errors from the API usually specify which required fields are missing or invalid; ensure all mandatory properties are correctly set.
- HTTP errors like 4xx or 5xx suggest issues with the request or server; check the input data and retry later if needed.
Links and References
- Cubo Suite CRM API Documentation (assumed based on base URL)
- n8n documentation on Creating Custom Nodes