L'API Ovalead

Branchez la fraîcheur CRM Ovalead à vos workflows : Zapier, n8n, Make, ou vos scripts maison. REST, JSON, authentification par clé. Disponible sur les plans payants.

Authentification

Toutes les requêtes utilisent l'en-tête X-API-Key avec une clé au format ovk_live_…. Vous générez vos clés depuis Paramètres → API. Les clés sont scopées au workspace et n'apparaissent qu'une seule fois — copiez-les immédiatement.

curl https://ovalead.com/api/v1/me \ -H "X-API-Key: ovk_live_VOTRE_CLE"

L'API est disponible sur les plans Trial, Pro et Enterprise. Le plan Free renvoie 402 Payment Required.

Démarrage rapide

1. Vérifier votre identité et votre plan

curl https://ovalead.com/api/v1/me \ -H "X-API-Key: ovk_live_…" # → { "org_id": "…", "org_name": "Acme", "plan": "pro", "auth_method": "api_key" }

2. Lister vos jobs d'enrichissement

curl "https://ovalead.com/api/v1/jobs?limit=10" \ -H "X-API-Key: ovk_live_…"

3. Récupérer les contacts d'un job

curl "https://ovalead.com/api/v1/jobs/47/contacts?status=success&limit=50" \ -H "X-API-Key: ovk_live_…"

4. Vérifier qu'un contact est toujours à jour

curl -X POST https://ovalead.com/api/v1/contacts/lookup \ -H "X-API-Key: ovk_live_…" \ -H "Content-Type: application/json" \ -d '{"linkedin_url": "https://linkedin.com/in/jane-doe"}'

Référence des endpoints

Base : https://ovalead.com/api/v1

GET/me

Identité du workspace, plan actif, méthode d'auth.

GET/quota

Quota mensuel : plan, used, limit, period_end.

GET/jobs

Liste paginée des jobs. Paramètres : status, limit (1-200), offset.

GET/jobs/{id}

Détail d'un job avec progression et compteurs (succès / échecs / changements détectés).

GET/jobs/{id}/contacts

Contacts enrichis du job. Filtres : status, change_detected (yes/no/unknown). Pagination : limit (1-500), offset.

GET/contacts/{id}

Vue complète d'un contact (poste actuel, entreprise, email, détection de changement).

POST/contacts/lookup

Recherche d'un contact par linkedin_url ou email. Retourne le contact le plus récemment traité.

Erreurs

Toutes les erreurs JSON suivent la même enveloppe :

{ "detail": { "error": { "code": "contact_not_found", "message": "No matching contact", "details": {} } } }

Zapier, n8n, Make

L'API est conçue pour les outils no-code. Configurez une action HTTP avec :

Cas d'usage typiques : déclencher un webhook quand change_detected = yes, synchroniser les contacts enrichis vers Notion / Airtable, alimenter un rapport hebdo Slack.

Une intégration prête à l'emploi à demander ?

Écrivez-nous, on packagera le connecteur Zapier ou n8n officiel selon la demande.

contact@ovalead.com