POST
/
contact
/
enrich
/
bulk
Enrich Contacts In Bulk
curl --request POST \
  --url https://app.fullenrich.com/api/v1/contact/enrich/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Sales Operations in London",
  "webhook_url": "https://example.com/webhook",
  "datas": [
    {
      "firstname": "john",
      "lastname": "snow",
      "domain": "example.com",
      "company_name": "example inc",
      "linkedin_url": "https://www.linkedin.com/in/demoge/",
      "enrich_fields": [
        "contact.emails",
        "contact.phones"
      ],
      "custom": {
        "user_id": "12584"
      }
    }
  ]
}'
{
  "enrichment_id": "2db5ea61-1752-42cf-8ea1-ab1da060cd0a"
}

​
Input needed

To enrich a contact, you must provide either:
  1. firstname + lastname & company (domain or the company_name)
  2. linkedin_url
For the best results, provide as much information as possible. Including a LinkedIn URL can improve enrichment rates by +5–20% for emails and +10–60% for mobile phone numbers. If you pass a linkedin_url, we will also return a full contact and company profile (job title, location, headcount, etc.).

​
Practical tips

You can enrich up to 100 contacts in bulk. If you want to enrich only 1 contact, you can pass only 1 contact in the list. All enrichments started on the API are visible on your FullEnrich dashboard. It is good practice to use a readable ‘name’ for each enrichment. This way, you can easily search through them. For instance, if you are enriching just one contact, you might name your enrichment ‘Firstname Lastname’. To pass specific properties, utilize the ‘custom’ field by passing an object. For example, if you are enriching a contact from your CRM, include the CRM ‘contact_id’ in the custom object. This allows you to reference the contact_id when you receive the result on your webhook. The custom value should be a cast as a string (number will return an error) To retrieve the results of your enrichment, you can either provide a webhook URL[recommended] or call the GET /bulk/enrichment_id endpoint [not recommended].

​
How do webhooks work?

Your webhook URL will receive a POST request when the enrichment is finished, lacks credits, or is canceled. If we fail to deliver a result to your webhook (receiving a non-2xx status code), we will retry every minute, up to 5 times. The content sent to your webhook is the same as that provided by the /bulk/enrichment_id endpoint.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
name
string
required
Examples:

"Sales Operations in London"

​
datas
object[]
required
​
webhook_url
string

If you are using n8n, this is where you add the Webhook that will be triggered when the enrichment is done.

Examples:

"https://example.com/webhook"

"https://n8n.com/webhook/36ajcd81-7f76-4b43-ab21-ba8a67264da7"

Response

OK

​
enrichment_id
string<uuid>
Examples:

"2db5ea61-1752-42cf-8ea1-ab1da060cd0a"