Actions20
Overview
This node interacts with the MOCO API to list companies based on various filtering and sorting criteria. It is useful for scenarios where users need to retrieve company data such as customers, suppliers, or organizations from MOCO, optionally filtered by IDs, update timestamps, tags, or search terms. For example, it can be used to fetch all customer companies updated after a certain date or to retrieve a limited number of companies matching specific tags.
Use Case Examples
- Fetch all companies of type 'customer' updated after a specific date.
- Retrieve up to 50 companies filtered by specific IDs and sorted by identifier.
- List companies with tags 'Network' and 'Important' containing the search term 'ACME'.
Properties
| Name | Meaning |
|---|---|
| Return All | Whether to return all results or only up to a given limit. |
| Limit | Maximum number of results to return when not returning all. |
| IDs | Filter by specific company IDs, comma-separated. |
| Updated After | Filter companies created or updated after this timestamp. |
| Additional Fields | Additional optional filters and parameters for listing companies, including identifier, sort field, tags, search term, and company type. |
Output
JSON
id- Unique identifier of the company.name- Name of the company.type- Type of the company (customer, supplier, organization).currency- Currency used by the company (if applicable).identifier- Company identifier.tags- Tags associated with the company.updated_at- Timestamp of the last update to the company.
Dependencies
- MOCO API
- API authentication token (credential)
Troubleshooting
- Ensure the API credentials are correctly configured to avoid authentication errors.
- If no results are returned, verify the filter parameters such as IDs, tags, or updatedAfter timestamp are correct and match existing data.
- Limit parameter must be a positive integer; setting it to zero or negative will cause errors.
- Network or API downtime may cause request failures; retry or check MOCO API status.
Links
- MOCO API - Companies Endpoint - Official MOCO API documentation for managing companies.