Dalil AI icon

Dalil AI

Consume Dalil AI API

Actions40

Overview

This node integrates with the Dalil AI API to manage company data within a CRM or business intelligence context. Specifically, the Company - Create operation allows users to create new company records by providing essential details such as the company name and various optional attributes like address, industry, employee count, and custom properties.

Typical use cases include:

  • Automating the addition of new companies from lead generation tools.
  • Enriching company profiles with detailed metadata for sales or marketing automation.
  • Integrating company creation into workflows that process incoming business inquiries or event registrations.

For example, you could use this node to automatically create a company record when a new contact form is submitted on your website, including location, industry, and social media links.

Properties

Name Meaning
Company Name The official name of the company (e.g., "Acme Corp", "TechStart Inc"). This is a required field.
Additional Fields A collection of optional fields to provide more detailed information about the company:
- Account Owner ID UUID string identifying the team member responsible for managing this company account.
- Address City City where the company is located (e.g., "New York", "San Francisco", "London").
- Address Country Country name (e.g., "United States", "Canada", "United Kingdom").
- Address Latitude Geographic latitude coordinate in decimal degrees (e.g., 40.7128 for New York City).
- Address Longitude Geographic longitude coordinate in decimal degrees (e.g., -74.0060 for New York City).
- Address Postcode Postal or ZIP code (e.g., "10001", "94105", "SW1A 1AA").
- Address State State, province, or region (e.g., "California", "New York", "Ontario").
- Address Street 1 Primary street address line (e.g., "123 Main Street", "456 Business Blvd").
- Address Street 2 Secondary street address line for suite, floor, etc. (e.g., "Suite 200", "Floor 5").
- Annual Recurring Revenue Amount Annual recurring revenue amount expressed in micros (e.g., 1000000 represents $1.00, 50000000 represents $50.00).
- Created By Source Name or ID Source indicating how the company was created (e.g., "EMAIL", "MANUAL", "IMPORT"). Selectable from predefined options or specified via expression.
- Currency Code Three-letter currency code for ARR (e.g., "USD", "EUR", "GBP"). Defaults to "USD".
- Custom Properties Custom fields specific to your workspace. Values depend on the field type: text fields accept strings, multi-select fields accept values like "ON_SITE", "HYBRID", "REMOTE_WORK", boolean fields accept true/false, etc.
- Domain Name Label Display label for the company website link (e.g., "Corporate Website", "Main Site").
- Domain Name URL The URL of the company website (e.g., "https://acmecorp.com", "https://techstart.io"). Used to fetch the company icon.
- Employees Total number of employees in the company (minimum value is 1).
- Ideal Customer Profile Boolean flag indicating whether this company matches your ideal customer profile criteria (true/false).
- Industry The industry or business sector of the company (e.g., "Technology", "Healthcare", "Finance").
- LinkedIn Label Display label for the LinkedIn profile link (e.g., "Official LinkedIn", "Company Page").
- LinkedIn URL URL of the company's LinkedIn profile (e.g., "https://linkedin.com/company/acme-corp").
- X (Twitter) Label Display label for the X (formerly Twitter) profile link (e.g., "Official Twitter", "Company Updates").
- X (Twitter) URL URL of the company's X (Twitter) profile (e.g., "https://x.com/acmecorp").

Output

The output of the node is a JSON object representing the newly created company record as returned by the Dalil AI API. This includes all the fields sent during creation along with any additional metadata or identifiers assigned by the system.

Example output structure (simplified):

{
  "id": "uuid-string",
  "name": "Acme Corp",
  "domainName": {
    "primaryLinkUrl": "https://acmecorp.com",
    "primaryLinkLabel": "Corporate Website",
    "secondaryLinks": []
  },
  "score": 85,
  "visibilityLevel": 2,
  "groupId": "uuid-string",
  "industry": "Technology",
  "employees": 150,
  "idealCustomerProfile": true,
  "accountOwnerId": "uuid-string",
  "tagline": "Innovating the future",
  "visaSponsorship": false,
  "linkedinLink": {
    "primaryLinkUrl": "https://linkedin.com/company/acme-corp",
    "primaryLinkLabel": "Official LinkedIn",
    "secondaryLinks": []
  },
  "xLink": {
    "primaryLinkUrl": "https://x.com/acmecorp",
    "primaryLinkLabel": "Official Twitter",
    "secondaryLinks": []
  },
  "annualRecurringRevenue": {
    "amountMicros": 50000000,
    "currencyCode": "USD"
  },
  "address": {
    "addressStreet1": "123 Main Street",
    "addressStreet2": "Suite 200",
    "addressCity": "New York",
    "addressPostcode": "10001",
    "addressState": "NY",
    "addressCountry": "United States",
    "addressLat": 40.7128,
    "addressLng": -74.0060
  },
  "introVideo": {
    "primaryLinkUrl": "https://youtube.com/example",
    "primaryLinkLabel": "Intro Video",
    "secondaryLinks": []
  },
  "workPolicy": ["ON_SITE"],
  "createdBy": {
    "source": "MANUAL"
  },
  "customProperty1": "value1",
  "customProperty2": true
}

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the Dalil AI API.
  • An API key credential must be configured in n8n to authenticate requests.
  • The node uses HTTP methods POST to /rest/companies endpoint to create company records.
  • Optional dependencies include access to metadata endpoints to load custom property options dynamically.

Troubleshooting

  • Invalid Property Metadata Error: If custom properties are incorrectly specified or malformed, the node throws errors indicating invalid property metadata. Ensure custom property JSON strings are valid and correspond to existing custom fields in your workspace.
  • API Authentication Errors: Failure to authenticate with the Dalil AI API will prevent company creation. Verify that the API key credential is correctly set up and has sufficient permissions.
  • Missing Required Fields: The "Company Name" is mandatory. Omitting it will cause the request to fail.
  • Unexpected API Response Structure: If the API response does not match expected formats, the node may throw errors. This can happen if the API changes or network issues occur.
  • Data Type Mismatches: For numeric fields like employees or ARR amount, ensure values are numbers and meet minimum constraints (e.g., employees ≥ 1).
  • Continue On Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error details in the output JSON.

Links and References

Discussion