Actions41
- Companies Actions
- Search companies
- Search companies (POST)
- Enrich company
- Search companies by name
- Search companies by prompt
- Search similar companies
- Count companies
- Count companies (POST)
- Enrich company by email
- Enrich company by social
- Get email patterns
- Ask company
- Get company context
- Fetch companies analytics
- Export companies analytics
- Lists Actions
- Locations Actions
- Business data Actions
- Actions Actions
- Prompts Actions
- Utilities Actions
Overview
This node integrates with The Companies API to enrich company data based on an email address. It allows users to fetch detailed information about a company associated with a given email, which can be useful for lead enrichment, customer profiling, or verifying company details in sales and marketing workflows.
Typical use cases include:
- Automatically enriching CRM records by providing company details from an email contact.
- Validating the company behind an email before outreach.
- Enhancing marketing segmentation by appending company attributes.
For example, given an email like contact@example.com, the node fetches comprehensive company data such as name, industry, size, location, and more.
Properties
| Name | Meaning |
|---|---|
| Refresh | Boolean flag to force refresh of cached company data (true/false). |
| Simplified | Boolean flag to request simplified company data instead of full detailed information. |
| The email address used to find and enrich the associated company information. |
Output
The node outputs JSON data containing the enriched company information retrieved from The Companies API. The structure typically includes various company attributes such as name, domain, industry, size, location, and other metadata depending on the API response.
If the API returns no data or an error occurs, the output JSON will contain an error message describing the issue.
No binary data output is produced by this node.
Dependencies
- Requires an API token credential for The Companies API to authenticate requests.
- Uses the official SDK of The Companies API (
@thecompaniesapi/sdk) bundled within the node. - No additional environment variables are required beyond the API token credential configured in n8n.
Troubleshooting
Common issues:
- Invalid or missing API token credential will cause authentication failures.
- Providing an invalid or malformed email may result in no company data found.
- Network connectivity issues can prevent successful API calls.
Error messages:
"Unknown operation: fetchCompanyByEmail": Indicates the operation parameter is incorrect or unsupported."SDK method fetchCompanyByEmail not found": Suggests a mismatch between the SDK version and the node implementation.- API errors returned from The Companies API will be passed through in the output JSON under an
errorfield if "Continue On Fail" is enabled.
Resolutions:
- Ensure the API token credential is correctly set up and valid.
- Verify the email input is properly formatted.
- Check network access and retry if transient errors occur.
- Enable "Continue On Fail" to handle individual item errors gracefully in batch executions.