Quickstart

Faites votre premier appel en quelques minutes.

1. Générez une clé API

Depuis votre espace Metaventus, ouvrez le Centre d'administration → Clés API et créez une clé secrète. Copiez-la en lieu sûr — elle n'est affichée qu'une fois.

La création de clés demande un plan professionnel : sur l'offre gratuite, l'API n'est pas ouverte.

À la création, vous pouvez restreindre la clé : portées (scopes) limitant les ressources accessibles, restriction par adresse IP, et date d'expiration.

2. Faites votre premier appel

Listez vos contacts :

curl "https://api.metaventus.com/v1/entities?entity_type=contact&page=1&page_size=25" \
  -H "X-API-Key: VOTRE_CLE_SECRETE" \
  -H "Content-Type: application/json"

Réponse (exemple) :

{
  "data": [
    {
      "id": "7f0d1c2e-…",
      "entity_type": "contact",
      "first_name": "Jean",
      "last_name": "Martin",
      "email": "jean@exemple.fr",
      "lifecycle_stage": "lead",
      "lead_score": 12
    }
  ],
  "meta": { "total": 1, "page": 1, "page_size": 25 }
}

Les réponses sont encapsulées dans data ; les listes paginées ajoutent un objet meta avec total, page et page_size.

3. Créez votre premier contact

curl -X POST "https://api.metaventus.com/v1/entities" \
  -H "X-API-Key: VOTRE_CLE_SECRETE" \
  -H "Content-Type: application/json" \
  -d '{
    "entity_type": "contact",
    "first_name": "Marie",
    "last_name": "Durand",
    "email": "marie@exemple.fr"
  }'

Et ensuite ?

• Parcourez la référence API complète (entités, opportunités, tâches, notes, segments).
• Lisez la page Authentification pour les portées et bonnes pratiques.
• Consultez les limites de débit avant de lancer vos imports.