HubSpot email enrichment
that actually works

import requests

API_KEY = "gtm_live_..."
BASE_URL = "https://api.gtmdata.co/v1"

# Validate an existing email
resp = requests.post(f"{BASE_URL}/validate", json={
    "email": "tim.cook@apple.com"
}, headers={"Authorization": f"Bearer {API_KEY}"})

result = resp.json()
print(f"Status: {result['status']}")  # valid, invalid, catchall

# Find an email by name + domain
resp = requests.post(f"{BASE_URL}/find", json={
    "first_name": "Tim",
    "last_name": "Cook",
    "domain": "apple.com"
}, headers={"Authorization": f"Bearer {API_KEY}"})

result = resp.json()
print(f"Found: {result['email']} ({result['status']})")

const API_KEY = "gtm_live_...";

// Validate an email
const validate = await fetch("https://api.gtmdata.co/v1/validate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ email: "tim.cook@apple.com" }),
});
const { status } = await validate.json();
console.log("Email status:", status);

// Find an email
const find = await fetch("https://api.gtmdata.co/v1/find", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    first_name: "Tim",
    last_name: "Cook",
    domain: "apple.com",
  }),
});
const result = await find.json();
console.log(`Found: ${result.email} (${result.status})`);

// In Clay, add an HTTP API enrichment column:
// Method: POST
// URL: https://api.gtmdata.co/v1/find
// Headers: { "Authorization": "Bearer gtm_live_..." }
// Body:
{
  "first_name": "{{First Name}}",
  "last_name": "{{Last Name}}",
  "domain": "{{Company Domain}}"
}

// Map response fields to new columns:
// $.email       -> Found Email
// $.status      -> Email Status
// $.confidence  -> Confidence
// $.convention  -> Email Convention

// Make: Use the "HTTP - Make a request" module
// Zapier: Use the "Webhooks by Zapier" action

// Step 1: Trigger (new CRM contact, new row, etc.)
// Step 2: HTTP POST to https://api.gtmdata.co/v1/find
//
// Headers:
//   Authorization: Bearer gtm_live_...
//   Content-Type: application/json
//
// Body (JSON):
{
  "first_name": "{{trigger.first_name}}",
  "last_name": "{{trigger.last_name}}",
  "domain": "{{trigger.company_domain}}"
}

// Step 3: Use the response to update your CRM
//   - email:      the found email address
//   - status:     valid / invalid / catchall
//   - confidence: 0 to 1
//   - provider:   google, microsoft, other