Erreurs

Toutes les erreurs ont le même format qu'Instantly : un code HTTP, répété dans un corps JSON.

json

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Campaign not found"
}

message est fait pour un humain (français ou anglais) : ne le comparez pas dans votre code, testez statusCode. Une erreur de validation nomme le champ fautif : leads.0.email: Invalid email address.

Codes

Code	Signification	Que faire
`400`	Paramètre ou corps invalide, JSON illisible, identifiant mal formé, référence vers un objet inconnu.	Corrigez la requête d'après message.
`401`	Clé absente, inconnue, révoquée ou expirée ; jeton OAuth expiré.	Vérifiez l'en-tête Authorization, renouvelez le jeton.
`402`	Quota du plan atteint, ou abonnement qui ne permet plus l'action.	Libérez de la place ou changez de plan.
`403`	Scope ou rôle insuffisant.	Créez une clé avec le scope indiqué dans message.
`404`	Objet introuvable dans le workspace de la clé.	Vérifiez l'identifiant et le workspace.
`409`	Conflit avec une valeur unique (nom, email, label déjà présent).	Lisez l'objet existant au lieu de le recréer.
`413`	Corps de plus de 5 Mo.	Découpez en lots (1 000 leads par appel).
`415`	Corps envoyé sans Content-Type: application/json.	Ajoutez l'en-tête.
`422`	Demande comprise mais impossible à traiter (refus du modèle d'IA).	Reformulez le contenu.
`429`	Limite de débit dépassée.	Attendez Retry-After secondes.
`500, 502, 503`	Erreur interne, service tiers en erreur (CRM, Google, Stripe, serveur mail), fonction non configurée.	Réessayez plus tard ; une 500 donne une référence à transmettre au support.

Une erreur 500 ne renvoie jamais de détail interne, seulement une référence courte (Erreur interne (réf. 3f9a1c2b)) qui permet de retrouver la trace côté serveur.