Enrich Contact

dropcontact.enrich_contact
ActionCRM & salesconnection required

Calls the Dropcontact API with the connection's credentials.

Start enrichment for one contact and return its request id. Dropcontact needs an email address, a LinkedIn URL, or a name together with a company.

Connection

Required
Yes — the node will not save without one
Auth type
API key
Providers
Dropcontact
Secret shape
the access token, or {"api_key": "…"}
Config it needs
base_url
Resolved by
config.connection_id, else node.connection_id

Configuration

17 fields, none required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
email
The contact's email address, which is enough on its own to enrich and is also what Dropcontact verifies.
stringNo—email formatada@example.com
first_name
The contact's first name; pair it with a company.
stringNo———
last_name
The contact's last name; pair it with a company.
stringNo———
full_name
The contact's full name; pair it with a company.
stringNo———
phone
A phone number already known for the contact.
stringNo———
company
Name of the company the contact works for.
stringNo———
website
Website of the contact's company.
stringNo—url format—
linkedin
The contact's LinkedIn profile URL, which is enough on its own.
stringNo—url formathttps://www.linkedin.com/in/ada-lovelace/
company_linkedin
The company's LinkedIn page URL.
stringNo—url format—
num_siren
The company's French SIREN number.
stringNo———
siret
The company's French SIRET number.
stringNo———
country
Two-letter country code to base the enrichment on, such as FR or US.
stringNo——FR
job
The contact's job title.
stringNo———
custom_fields
Your own keys as a JSON object; Dropcontact stores them untouched and returns them with the result.
objectNo——{"crm_id":"18181818181818"}
siren
Set true to also return the SIREN number, NAF code, VAT number, company address and company leader for French entities.
booleanNo———
language
Set to 'en' for results in English; leave blank and Dropcontact answers in French.
stringNo——en
custom_callback_url
URL Dropcontact should POST the finished results to, instead of waiting to be polled; it takes precedence over the account's default webhook.
stringNo—url formathttps://hooks.example.com/dropcontact
  • At least one of email, linkedin, full_name, first_name must be set.

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "country": "FR",
  "custom_callback_url": "https://hooks.example.com/dropcontact",
  "custom_fields": {
    "crm_id": "18181818181818"
  },
  "email": "ada@example.com",
  "language": "en",
  "linkedin": "https://www.linkedin.com/in/ada-lovelace/"
}

Output

One shape.

result

FieldTypeExample
request_id
Feed this to Dropcontact: Get Enrichment to read the result.
string—
credits_left
How many enrichment credits the account has left.
number—
success
True when Dropcontact accepted the request.
boolean—
error
False when nothing went wrong, otherwise Dropcontact's message.
any—
data
The rows as Dropcontact echoed them back, with any warnings.
array—
{
  "credits_left": 0,
  "data": [],
  "error": null,
  "request_id": "",
  "success": false
}

See Enrich Contact run in a workflow.

In a technical demo we add the Dropcontact connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.