Actions25
Overview
This node integrates with the Tiny ERP API v3 to manage various business resources, including contacts. Specifically, for the Contact resource and the Create operation, it allows users to create new contact entries in their Tiny ERP system. This is useful for automating the addition of new contacts such as clients, suppliers, or partners directly from workflows without manual data entry.
Practical examples include:
- Automatically adding a new customer contact when a form is submitted on a website.
- Syncing contacts from a CRM or marketing platform into Tiny ERP.
- Creating supplier contacts when onboarding new vendors.
Properties
| Name | Meaning |
|---|---|
| Additional Fields | A collection of optional fields to specify details about the contact. Includes: |
| - Name | The name of the contact item. |
| - Description | Description of the item (optional). |
| - Price | Price associated with the item (not typically used for contacts but available). |
| - SKU | SKU or code identifier (not typical for contacts but present). |
| Email address of the contact. | |
| - Phone | Phone number of the contact. |
| - Document | CPF or CNPJ document number (Brazilian individual or company tax IDs). |
| - Address | Physical address of the contact. |
| - City | City where the contact is located. |
| - State | State (UF) abbreviation. |
| - ZIP Code | Postal code (CEP). |
These fields allow flexible input of contact information when creating a new contact record.
Output
The node outputs JSON data representing the newly created contact as returned by the Tiny ERP API. The structure includes all the contact details stored in Tiny ERP after creation, such as assigned IDs and any default values set by the system.
No binary data output is produced by this operation.
Dependencies
- Requires an OAuth2 API credential configured in n8n to authenticate requests against the Tiny ERP API.
- Network access to
https://erp.tiny.com.br/public-api/v3is necessary. - The node uses the
tinyOAuth2Apicredential type for authentication (configured externally).
Troubleshooting
Common issues:
- Authentication failures due to invalid or expired OAuth tokens.
- Missing required fields causing API validation errors.
- Network connectivity problems preventing API calls.
Error messages:
"Tiny ERP API request failed: <message>"indicates an issue communicating with the API. Check credentials and network."Unknown operation: create"would indicate a misconfiguration of the operation parameter (unlikely if using UI).
Resolutions:
- Verify that the OAuth2 credentials are correctly set up and authorized.
- Ensure required fields like "Name" are provided in the additional fields.
- Confirm internet connectivity and API endpoint availability.
Links and References
- Tiny ERP Public API Documentation (official API docs)
- n8n OAuth2 Credential Setup (for configuring OAuth2 credentials)
This summary focuses on the Contact resource's Create operation based on the provided source code and property definitions.