Dalil AI icon

Dalil AI

Consume Dalil AI API

Overview

This node integrates with the Dalil AI API to manage various CRM-related resources such as companies, people, notes, opportunities, tasks, and pipelines. Specifically for the Company - Get operation, it retrieves detailed information about a single company identified by its unique UUID. The node supports fetching nested related objects up to two levels deep, allowing users to obtain not only the primary company data but also associated entities like contacts or opportunities linked to that company.

Typical use cases include:

  • Fetching comprehensive company profiles for sales or marketing automation.
  • Integrating company data into workflows for reporting or enrichment.
  • Retrieving related records (e.g., contacts, deals) alongside the company for context-aware processing.

Example: Given a company UUID, the node can return the company's details along with its direct relations (depth 1), such as contacts and open deals, or even relations of those related objects (depth 2).

Properties

Name Meaning
Company ID UUID string identifying the company to retrieve.
Depth Name or ID Level of nested related objects to include in the response:
- 0: Only the company data.
- 1: Company plus directly related objects.
- 2: Company, its related objects, and their related objects.
Options are selectable from a list or can be specified dynamically via expressions.

Output

The output is a JSON object representing the company data retrieved from the Dalil AI API. The structure includes:

  • Core company fields such as name, domain, industry, employees, score, visibility level, address, and more.
  • Nested related objects depending on the selected depth parameter, which may include contacts, opportunities, tasks, notes, etc.
  • Custom properties if defined and active in the Dalil AI system.

The output is paired with the input item index for traceability.

No binary data is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Dalil AI API.
  • The node makes HTTP requests to Dalil AI REST endpoints.
  • No additional environment variables are needed beyond the configured API authentication.

Troubleshooting

  • Invalid Company ID: If the provided UUID is incorrect or does not exist, the API will likely return an error or empty result. Verify the UUID format and existence.
  • Depth Parameter Issues: Providing an unsupported depth value may cause unexpected results or errors. Use only the allowed values (0, 1, 2).
  • API Errors: Network issues or invalid credentials will cause request failures. Ensure the API key is valid and network connectivity is stable.
  • Custom Property Processing Errors: If custom properties are malformed or contain invalid metadata, the node throws errors indicating failure to process them. Review custom property definitions carefully.

Common error messages:

  • "Unexpected API response structure": Indicates the API returned data in an unexpected format; check API version compatibility.
  • "Invalid property metadata": Occurs when custom property metadata cannot be parsed; verify custom property configuration.

Links and References

Discussion