API Reference · crm record
Enrich HubSpot contacts via API
Enrich HubSpot contacts in place — no CSV export needed.
Endpoint
POST https://api.cleanlist.ai/v1/enrich/hubspot_contactRequest
POST https://api.cleanlist.ai/v1/enrich/hubspot_contact
Authorization: Bearer clnl_live_...
Content-Type: application/json
{
"email": "jane@acme.com"
}Response
{
"id": "ev_abc123",
"hubspot_contact": {
"hubspot_contact_id": "<hubspot_contact_id>",
"email": "<email>",
"enriched_title": "<enriched_title>",
"enriched_company": "<enriched_company>",
"enriched_phone": "<enriched_phone>"
},
"meta": {
"credits_used": 11,
"providers_queried": 15
}
}Field reference
| Field | Type | Description |
|---|---|---|
| hubspot_contact_id | string | — |
| string | — | |
| enriched_title | string | — |
| enriched_company | string | — |
| enriched_phone | string | — |
Code samples
curl
curl -X POST https://api.cleanlist.ai/v1/enrich/hubspot_contact \
-H "Authorization: Bearer $CLEANLIST_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "jane@acme.com"}'Node.js
import Cleanlist from "cleanlist";
const client = new Cleanlist(process.env.CLEANLIST_API_KEY);
const result = await client.enrich.hubspot_contact({
email: "jane@acme.com",
});
console.log(result.hubspot_contact.title);Python
from cleanlist import Cleanlist
client = Cleanlist(api_key=os.environ["CLEANLIST_API_KEY"])
result = client.enrich.hubspot_contact(email="jane@acme.com")
print(result["hubspot_contact"]["title"])Pricing
Credit-based, no per-seat fees. This endpoint uses the standard enrichment rate:
- Email only: 1 credit per enriched hubspot_contact.
- Email + phone: 11 credits per enriched hubspot_contact.
- Free tier: 30 credits/mo. See all pricing.
Next steps
- Full REST reference: /product/api.
- Related glossary: data enrichment, waterfall enrichment.
- Ready to ship? Start free with 30 credits.