Asaas icon

Asaas

Integração com a API do Asaas para pagamentos e cobranças
Join our community

Actions29

Overview

This node integrates with the Asaas API to manage customers, payments, subscriptions, webhooks, payment links, anticipations, and splits. Specifically, for the Cliente (Customer) - Criar (Create) operation, it allows creating a new customer record in the Asaas system by providing essential customer details such as name, CPF/CNPJ (Brazilian individual or company tax ID), contact information, and address.

Common scenarios where this node is beneficial include automating customer onboarding processes, synchronizing customer data from other systems into Asaas, or setting up billing workflows that require customer registration before issuing payments or subscriptions.

Practical example:
A business uses n8n to automate its sales process. When a new lead converts, the workflow creates a customer in Asaas using this node, supplying their name, tax ID, email, and phone number. This enables subsequent automated invoicing and payment collection via Asaas.

Properties

Name Meaning
Nome Customer's full name (required).
CPF/CNPJ Customer's CPF or CNPJ number (Brazilian tax ID, numbers only) (required).
Email Customer's email address.
Telefone Celular Customer's mobile phone number (numbers only).
Telefone Fixo Customer's landline phone number (numbers only).
CEP Postal code of the customer's address (numbers only).
Número Do Endereço Street number of the customer's address.
Complemento Additional address information (e.g., apartment, suite).

Output

The node outputs JSON data representing the newly created customer object returned by the Asaas API. This typically includes fields such as the customer ID, name, tax ID, contact details, and address information as stored in Asaas.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Asaas API.
  • The node uses the Asaas API base URL, which switches between sandbox and production environments based on the credential configuration.
  • No additional external dependencies beyond the Asaas API are required.

Troubleshooting

  • Package Removed Error:
    If the node throws an error indicating the package was removed from npm and is no longer available, it means the underlying integration package is deprecated or missing. The resolution is to remove or update the node in your n8n installation.

  • Invalid or Missing Required Fields:
    Errors may occur if required fields like "Nome" or "CPF/CNPJ" are missing or invalid. Ensure these fields are correctly filled with valid data.

  • API Authentication Errors:
    If authentication fails, verify that the API key credential is correctly configured and has appropriate permissions.

  • Network or Timeout Issues:
    Network connectivity problems or slow responses from the Asaas API can cause request failures. Check network status and retry.

Links and References

Discussion