Actions34
- Activity Actions
- Deal Actions
- Funnel Actions
- Organization Actions
- Person Actions
- Product Actions
- Tag Actions
- User Actions
Overview
This node integrates with the Agendor CRM API to update existing deals (business opportunities). It allows users to modify key details of a deal such as its title, value, and various additional fields related to the deal, organization, or person involved. This is useful in sales automation workflows where deal information needs to be kept current based on external triggers or data changes.
Practical examples include:
- Automatically updating the value or title of a deal when a new quote is generated.
- Modifying associated contact or organization IDs when relationships change.
- Adding descriptive notes or other metadata to deals during pipeline progression.
Properties
| Name | Meaning |
|---|---|
| Deal ID | The numeric identifier of the deal to update. |
| Title | The title or name of the deal (e.g., "Venda de Software - Empresa ABC"). |
| Value | The monetary value of the deal in cents (e.g., 1000 = R$ 10,00). |
| Additional Fields | Optional extra fields to update, including: |
| - Address | Full address (shown for people and organizations). |
| - CNPJ | Organization's CNPJ number (Brazilian company tax ID, numbers only). |
| - CPF | Person's CPF number (Brazilian individual tax ID, numbers only). |
| - Description | Detailed description or notes about the deal. |
| - Organization ID | ID of the related organization. |
| - Person ID | ID of the person responsible for the deal. |
| - Phone | Phone number (for people and organizations). |
| - Website | Website URL (for organizations). |
Output
The node outputs JSON data representing the updated deal object returned by the Agendor API after the update operation. This typically includes all the deal's properties such as ID, title, value, related person and organization IDs, timestamps, and any other metadata maintained by the CRM.
No binary data output is produced by this node.
Dependencies
- Requires an API authentication token credential for the Agendor CRM API.
- The base URL used for requests is
https://api.agendor.com.br/v3. - Proper configuration of the API token in n8n credentials is necessary for authorization.
Troubleshooting
Common issues:
- Invalid or missing Deal ID will cause the update request to fail.
- Incorrect API token or expired credentials will result in authorization errors.
- Providing invalid field formats (e.g., non-numeric values for IDs or value) may cause validation errors from the API.
Error messages:
- 401 Unauthorized: Check that the API token credential is correctly set and valid.
- 404 Not Found: Verify the Deal ID exists in the Agendor system.
- 400 Bad Request: Ensure all required fields are provided and formatted correctly, especially numeric fields like value and IDs.
To resolve errors, confirm input parameters, validate credentials, and consult the Agendor API documentation for field requirements.