Clearbit integration

Overview

Clearbit is a data enrichment service. This tool supports three operations: (1) Person Enrich — look up social and professional information by email address, (2) Company Enrich — look up detailed company data by domain, and (3) Company Autocomplete — auto-complete company names and get domain/logo.

Node Type

Action — processes input items and produces output

Input / Output

Direction	Port(s)
Input	Input
Output	Output, Error

Credentials

This tool requires Clearbit API credentials. See the Credentials Guide for setup instructions.

Resources

Resource	Value
Company	company
Person	person

Operations

Which operations are available depends on the selected resource — see the parameter subsections below.

Operation	Value	Description
Autocomplete	autocomplete	Auto-complete company names and retrieve logo and domain.
Enrich	enrich	Look up person and company data based on an email or domain.

Parameters

Company: Enrich

Parameter	Type	Required	Default	Description
Domain	string	Yes	—	The domain to look up.
Additional Fields	collection	No	{}	Extra hints sent with the lookup to improve the match.
— Company Name	string	No	—	The name of the company.
— Facebook	string	No	—	The Facebook URL for the company.
— LinkedIn	string	No	—	The LinkedIn URL for the company.
— Twitter	string	No	—	The Twitter handle for the company.

Company: Autocomplete

Parameter	Type	Required	Default	Description
Name	string	Yes	—	The partial name of the company to search for.

Person: Enrich

Parameter	Type	Required	Default	Description
Email	string	Yes	—	The email address to look up.
Additional Fields	collection	No	{}	Extra hints sent with the lookup to improve the match.
— Company	string	No	—	The name of the person’s employer.
— Company Domain	string	No	—	The domain for the person’s employer.
— Facebook	string	No	—	The Facebook URL for the person.
— Family Name	string	No	—	Last name of person. Passing this is strongly recommended to improve match rates.
— Given Name	string	No	—	First name of person.
— IP Address	string	No	—	IP address of the person. Passing this is strongly recommended to improve match rates.
— LinkedIn	string	No	—	The LinkedIn URL for the person.
— Location	string	No	—	The city or country where the person resides.
— Twitter	string	No	—	The Twitter handle for the person.

All Operations

Parameter	Type	Required	Default	Description
Max Concurrency	number	No	10	Maximum number of items to process concurrently.

Output Data

Clearbit’s response is merged onto the input item’s JSON — your existing fields survive and the enrichment fields are added alongside them, overwriting any key of the same name. Binary data on the input item is forwarded.

Operation	Output items per input item
company / enrich	One — the company record merged onto the item.
person / enrich	One — the person record merged onto the item.
company / autocomplete	One per suggestion, so a single input item fans out into several.

An autocomplete lookup that matched nothing still produces one item, carrying your original JSON plus a marker:

{
  "_noResults": true
}

Test for {{ $json._noResults }} before treating an autocomplete branch as a hit. The two enrich operations have no such marker — an empty response simply leaves the item as it arrived, so check for a field you expect (for example {{ $json.name }}) instead.

The enrichment fields themselves are whatever Clearbit returns for the lookup; the node does not rename, nest or filter them. Reference them downstream by expression, e.g. {{ $json.domain }}.

Example Configuration

Enrich a company from a domain on the item:

{
  "type": "clearbit",
  "parameters": {
    "resource": "company",
    "operation": "enrich",
    "domain": "{{ $json.domain }}"
  }
}

Give the company lookup extra hints to improve the match:

{
  "type": "clearbit",
  "parameters": {
    "resource": "company",
    "operation": "enrich",
    "domain": "{{ $json.website }}",
    "additionalFields": {
      "companyName": "{{ $json.company }}",
      "linkedin": "{{ $json.linkedinUrl }}",
      "twitter": "{{ $json.twitterHandle }}"
    }
  }
}

Suggest companies from a partial name typed by a user:

{
  "type": "clearbit",
  "parameters": {
    "resource": "company",
    "operation": "autocomplete",
    "name": "{{ $json.query }}"
  }
}

Enrich a lead by email, passing name and location to raise the match rate:

{
  "type": "clearbit",
  "parameters": {
    "resource": "person",
    "operation": "enrich",
    "email": "{{ $json.email }}",
    "additionalFields": {
      "givenName": "{{ $json.firstName }}",
      "familyName": "{{ $json.lastName }}",
      "company": "{{ $json.company }}",
      "companyDomain": "{{ $json.domain }}",
      "location": "{{ $json.city }}"
    },
    "maxConcurrency": 5
  }
}

Error Handling

Mode	Behavior
stop	Halts workflow on first error
continue	Skips failed items, passes successful ones through
errorPort	Routes failed items to Error output port

Tips

This tool enriches company and person data using the Clearbit service, and it can also autocomplete company names. It is ideal when you need to look up detailed company information by domain, find social and professional data for a person by email, or provide company name suggestions. It produces comprehensive company profiles, person-specific social and professional details, or a list of company names with their associated domains and logos.

Parameter Dependencies

• operation options depend on the selected resource
• domain is only required for company enrichment
• name is only required for company autocomplete
• email is only required for person enrichment
• additionalFields structure varies by resource type
• All conditional parameters are hidden unless their display conditions are met