Actions68
- Email Actions
- File Actions
- Note Actions
- Product Category Actions
- Task Actions
- Address Actions
- Company Actions
- Custom Record Actions
- Deal Actions
- Deal Item Actions
- Person Actions
- Phone Actions
- Product Actions
Overview
The node integrates with Arivo CRM to retrieve multiple address records associated with a specific contact. The "Get Many" operation under the "Address" resource fetches addresses linked to a given contact ID, optionally filtered by city, state, or country. It supports pagination controls such as limiting the number of results or returning all available addresses. This node is useful in scenarios where you need to bulk retrieve address data for contacts, for example, to synchronize contact locations, generate mailing lists, or analyze geographic distribution of contacts.
Practical examples:
- Fetching all addresses for a customer to verify shipping and billing locations.
- Retrieving a limited set of addresses filtered by country to target marketing campaigns.
- Sorting addresses by creation date to get the most recent entries first.
Properties
| Name | Meaning |
|---|---|
| Contact ID | The unique identifier of the contact whose addresses are to be retrieved. (Required) |
| Return All | Boolean flag indicating whether to return all matching addresses or limit the number returned. |
| Limit | Maximum number of address records to return when "Return All" is false. Minimum value is 1. |
| Filters | Optional filters to narrow down addresses by: |
| - City: Filter addresses by city name. | |
| - State: Filter addresses by state name. | |
| - Country: Filter addresses by country name. | |
| Options | Additional options for sorting the results: |
| - Sort Field: Field to sort by; options include City, Country, Created At, State, Updated At. | |
| - Sort Order: Sort direction; either Ascending or Descending. |
Output
The output is an array of JSON objects, each representing an address record associated with the specified contact. Each object contains the address details as provided by Arivo CRM, which typically includes fields like street, city, state, country, postal code, and timestamps for creation and updates.
The output items are paired with their corresponding input items to maintain traceability.
No binary data is output by this node.
Dependencies
- Requires an active connection to Arivo CRM via an API key credential configured in n8n.
- The node depends on the Arivo CRM API being accessible and the user having appropriate permissions to read address data.
- No additional environment variables or external services are required beyond the API authentication.
Troubleshooting
Common Issues:
- Invalid or missing Contact ID will result in errors or empty results.
- Network connectivity issues can cause request failures.
- Insufficient permissions in Arivo CRM may lead to authorization errors.
- Using filters that do not match any addresses will return an empty list.
Error Messages:
- Errors related to authentication usually indicate invalid or expired API credentials; reconfigure the API key.
- Rate limiting or quota exceeded errors require checking Arivo CRM API usage limits.
- Validation errors on parameters (e.g., invalid limit values) should be corrected according to property constraints.
Links and References
- Arivo CRM Official Documentation (hypothetical link as no direct link was provided)
- n8n Documentation on Creating Custom Nodes
- General API best practices for pagination and filtering.