Limites de débit

Les limites protègent l'envoi de tous les workspaces. Elles sont comptées sur des fenêtres fixes d'une minute.

Limite	Valeur	Compté par
Toute requête	600 requêtes par minute	adresse IP, avant authentification
Requêtes authentifiées	600 requêtes par minute	clé API, jeton OAuth ou utilisateur connecté
Actions sensibles	20 requêtes par minute	clé et route (tests de webhooks et d'outils, simulations et variantes IA, enrichissement IA, tests de boîtes, synchronisation CRM)

Les actions sensibles sont signalées dans la référence par « action sensible » à côté du scope. Elles coûtent des appels à des services tiers (modèles d'IA, serveurs mail, CRM).

Dépassement

L'API répond 429 Too Many Requests avec l'en-tête Retry-After (secondes avant la fin de la fenêtre) :

http

HTTP/1.1 429 Too Many Requests
Retry-After: 23
Content-Type: application/json

{ "statusCode": 429, "error": "Too Many Requests", "message": "Trop de requêtes, réessayez dans un instant" }

Attendez la durée indiquée, puis réessayez :

Node.js

async function call(url, init, attempt = 0) {
  const res = await fetch(url, init);
  if (res.status === 429 && attempt < 5) {
    const wait = Number(res.headers.get("Retry-After") ?? 1);
    await new Promise((r) => setTimeout(r, wait * 1000));
    return call(url, init, attempt + 1);
  }
  return res;
}

Quotas du plan

Indépendamment du débit, le plan du workspace fixe des quotas (boîtes d'envoi, leads et emails par mois, crédits IA, membres). Une création qui dépasse un quota répond 402 Payment Required. La consommation du mois est lisible avec GET /billing.

Conseils

Importez les leads par lots de 1 000 avec POST /leads/add plutôt qu'un par un.
Préférez les webhooks à l'interrogation répétée de l'inbox ou des leads.
Une clé par intégration : chacune a son propre compteur.