Overview
This node integrates with the Asaas API to manage customer data. Specifically, for the "Cliente" (Customer) resource and the "Criar" (Create) operation, it allows users to create new customer records in the Asaas system by providing essential customer details such as name, CPF/CNPJ (Brazilian individual or company tax ID), email, and various optional additional fields.
Common scenarios where this node is beneficial include automating customer onboarding processes, syncing customer data from other systems into Asaas, or bulk-creating customers based on input data streams.
For example, a business could use this node to automatically add new customers collected from a web form into their Asaas account, ensuring that all relevant customer information is stored centrally and ready for billing or communication purposes.
Properties
| Name | Meaning |
|---|---|
| Nome | Customer's full name (required). |
| CPF/CNPJ | Customer's CPF or CNPJ number (Brazilian tax identification, required). |
| Customer's primary email address. | |
| Campos Adicionais | Additional optional fields: |
| - Bairro | Customer's neighborhood. |
| - Celular | Customer's mobile phone number. |
| - CEP | Customer's postal code. |
| - Cliente Estrangeiro | Boolean indicating if the customer is foreign. |
| - Complemento | Address complement (e.g., apartment number). |
| - Emails Adicionais | Additional emails separated by commas. |
| - Empresa | Customer's company name. |
| - Endereço | Customer's street address. |
| - Inscrição Estadual | State registration number of the customer. |
| - Inscrição Municipal | Municipal registration number of the customer. |
| - Nome Do Grupo | Customer group name. |
| - Notificação Desabilitada | Boolean to disable notifications for this customer. |
| - Número | Address number. |
| - Observações | Notes or observations about the customer. |
| - Referência Externa | External reference identifier for the customer. |
| - Telefone | Customer's phone number. |
Output
The node outputs JSON objects representing the created customer record as returned by the Asaas API. The output includes all customer details stored in Asaas, including any IDs assigned by the system and status information.
If multiple input items are processed, each output item corresponds to one created customer, paired with the original input item index.
No binary data is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the Asaas API.
- The node supports two environments: production and sandbox, selectable via the credential configuration.
- The node makes HTTP requests to the Asaas REST API endpoints under
/v3/customers.
Troubleshooting
- Authentication errors: Ensure the API key credential is correctly configured and has the necessary permissions.
- Validation errors: Required fields like "Nome" and "CPF/CNPJ" must be provided and valid according to Brazilian standards.
- API environment mismatch: Verify whether you are using the sandbox or production environment and that the API key matches the selected environment.
- Network issues: Confirm network connectivity to the Asaas API endpoints.
- Error messages from API: The node surfaces error messages returned by the Asaas API; review these messages for specific causes such as duplicate customers or invalid data formats.