Documentation API

Intégrez Magic-Lead avec vos outils : Zapier, n8n, Make, ou vos applications custom

Gérer les clés APIOpenAPI JSON

1. Créer une clé API

Générez une clé API avec les permissions nécessaires (read, write, delete).

Créer une clé

2. Authentifier

Ajoutez le header Authorization: Bearer ml_xxx

3. Intégrer

Utilisez les endpoints pour gérer contacts, campagnes, stats et plus.

Exemples rapides

Copiez-collez ces exemples cURL pour commencer

GET
Lister les contacts
/api/v1/contacts
curl -X GET "https://magic-lead.com/api/v1/contacts?page=1&limit=50" \
  -H "Authorization: Bearer ml_votre_cle_api"
POST
Créer un contact
/api/v1/contacts
curl -X POST "https://magic-lead.com/api/v1/contacts" \
  -H "Authorization: Bearer ml_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "firstName": "Jean",
    "lastName": "Dupont",
    "company": "Entreprise SAS"
  }'
POST
Lancer une campagne
/api/v1/campaigns/{id}/launch
curl -X POST "https://magic-lead.com/api/v1/campaigns/abc123/launch" \
  -H "Authorization: Bearer ml_votre_cle_api"
GET
Statistiques globales
/api/v1/stats
curl -X GET "https://magic-lead.com/api/v1/stats?period=30d" \
  -H "Authorization: Bearer ml_votre_cle_api"

Documentation interactive

Testez les endpoints directement depuis cette page

Chargement de la documentation...

Limites et quotas

Rate Limit

1000

requêtes/heure par clé

Pagination max

100

résultats par page

Timeout

30s

par requête