The Companies API icon

The Companies API

Access company data, enrichment, analytics and more using The Companies API

Overview

This node integrates with The Companies API to manage and interact with various company-related actions. Specifically, the "Retry action" operation allows users to retry a previously executed action by providing its unique Action ID. This is useful in scenarios where an enrichment or data retrieval action failed or needs to be re-executed without creating a new request from scratch.

Practical examples include:

  • Automatically retrying failed data enrichment requests for companies.
  • Re-running analytics or data fetch actions that did not complete successfully.
  • Managing asynchronous or long-running tasks by triggering retries on demand.

Properties

Name Meaning
Action ID The unique numeric identifier of the action to retry.

Output

The node outputs JSON data representing the result of the retried action. The structure typically contains the response data from The Companies API about the retried action, including status, results, or error information if applicable.

If the action involves binary data (not indicated here), it would be included accordingly, but this operation primarily returns JSON data related to the action's retry status and details.

Dependencies

  • Requires an API token credential for authenticating with The Companies API.
  • Uses the official SDK of The Companies API (@thecompaniesapi/sdk) to perform operations.
  • The node expects the API token to be configured in n8n credentials under a generic API key/token authentication.

Troubleshooting

  • Unknown operation error: If the operation parameter is incorrect or missing, the node throws an error indicating an unknown operation. Ensure the operation is set to "retryAction".
  • SDK method not found: If the SDK does not have the expected method, it indicates a mismatch between the node code and the SDK version. Updating the SDK or node may resolve this.
  • Invalid or missing Action ID: Providing an invalid or empty Action ID will cause the API call to fail. Verify that the Action ID is correct and corresponds to an existing action.
  • API authentication errors: If the API token is invalid or missing, the node will fail to authenticate. Check the configured credentials.
  • Continue on Fail: If enabled, the node will output error messages per item instead of stopping execution, which helps in batch processing scenarios.

Links and References

Discussion