Actions14
Overview
This node integrates with the Gestor Clientes Max API to manage client data, including creating, retrieving, updating, deleting, and searching clients. Specifically, the Update operation for the Cliente (Client) resource allows users to update existing client information such as name, email, phone number, and CPF (Brazilian individual taxpayer registry identification).
Typical use cases include:
- Keeping client records up-to-date in an automated workflow.
- Synchronizing client details from other systems or forms.
- Correcting or adding missing client information programmatically.
For example, a business could automate updating client contact details after receiving new information from a CRM or customer support system.
Properties
| Name | Meaning |
|---|---|
| Client ID | The unique numeric identifier of the client to update. |
| Nome | The full name of the client. |
| The client's email address. | |
| Telefone | The client's phone number. |
| CPF | The client's CPF number (optional Brazilian tax ID). |
Output
The node outputs JSON data representing the updated client object returned by the Gestor Clientes Max API. This typically includes all client fields after the update, confirming the changes made.
No binary data output is involved.
Example output JSON structure (simplified):
{
"id": 123,
"name": "Updated Client Name",
"email": "client@example.com",
"phone": "+5511999999999",
"cpf": "123.456.789-00"
}
Dependencies
- Requires an API key credential for authenticating with the Gestor Clientes Max API.
- The node uses HTTP requests to the API base URL configured in the credentials.
- Proper network access to the Gestor Clientes Max API endpoint is necessary.
Troubleshooting
Common issues:
- Invalid or missing Client ID will cause the update to fail.
- Incorrect API key or expired token will result in authentication errors.
- Missing required fields (name, email, phone) will cause validation errors.
- Network connectivity problems can prevent successful API calls.
Error messages:
"Unknown operation: client.update": Indicates a misconfiguration or unsupported operation.- HTTP 401 Unauthorized: Check that the API key credential is valid and correctly set.
- HTTP 404 Not Found: The specified Client ID does not exist.
- Validation errors from the API will be returned in the response; ensure all required fields are provided.
To resolve errors, verify input parameters, confirm API credentials, and check network connectivity.
Links and References
- Gestor Clientes Max API Documentation (example placeholder, replace with actual if available)
- n8n HTTP Request Node documentation: https://docs.n8n.io/nodes/n8n-nodes-base.httpRequest/