Temps limité : 30% DE RÉDUCTION sur votre premier paiement.
API REST publique

InboxWarm propose une API publique de Warmup d'Email

Automatisez le warmup, extrayez les données de délivrabilité et gérez chaque boîte de réception de façon programmatique — 27 endpoints REST, inclus dans tous les forfaits.

Dernière mise à jour :

En bref

InboxWarm propose une API REST publique avec 27 endpoints répartis en 5 catégories — Comptes email, Warmup, Délivrabilité, Rapports et Système. Elle permet de connecter des boîtes de réception, de démarrer et d'arrêter le warmup, et d'extraire des scores de délivrabilité et des rapports vers vos propres outils. L'accès est inclus dans tous les forfaits sans coût supplémentaire : inscrivez-vous, générez une clé dans Developer Kit > API Integration, et effectuez votre premier appel en moins de 5 minutes.

Pourquoi l'API

Pourquoi utiliser l'API InboxWarm ?

L'API InboxWarm existe pour que vous puissiez exécuter le warmup d'email et le suivi de la délivrabilité depuis votre propre produit, vos scripts et vos tableaux de bord, plutôt que depuis l'application web InboxWarm.

Automatisez le démarrage et l'arrêt du warmup

Lancez le warmup dès qu'une nouvelle boîte de réception est provisionnée et mettez-le en pause lorsqu'une campagne démarre — sans aucun clic sur le tableau de bord.

Extrayez les données de délivrabilité vers vos propres tableaux de bord

Envoyez les scores de configuration, l'état DNS, le placement en boîte de réception et les rapports quotidiens de warmup directement vers votre outil BI ou votre back-office.

Connectez InboxWarm à votre produit ou à vos outils internes

Gérez les boîtes de réception de façon programmatique depuis votre parcours d'onboarding, votre CRM ou le back-office de votre agence grâce à de simples appels REST.

Inclus dans tous les forfaits, sans coût supplémentaire

Chaque forfait InboxWarm inclut un accès complet à l'API sans frais additionnels — générez une clé et commencez à appeler les endpoints dès aujourd'hui.

Fonctionnalités

Que pouvez-vous faire avec l'API InboxWarm ?

L'API de warmup d'email couvre 27 endpoints REST répartis en 5 catégories ; la référence complète endpoint par endpoint se trouve dans la référence publique de l'API.

8 endpoints

Comptes email

Connectez des boîtes Gmail, Microsoft ou SMTP/IMAP, vérifiez leur état de connexion et gérez-les individuellement ou en masse.

9 endpoints

Warmup

Démarrez, arrêtez et configurez le warmup d'email pour n'importe quelle boîte de réception — y compris des actions en masse sur jusqu'à 50 boîtes en un seul appel.

4 endpoints

Délivrabilité

Vérifiez les scores de configuration, effectuez des contrôles DNS en direct (SPF, DKIM, DMARC, MX) et mesurez le placement boîte de réception/spam par fournisseur.

4 endpoints

Rapports

Extrayez des rapports quotidiens de warmup, des résumés de tableau de bord à l'échelle du compte et des exports CSV asynchrones vers vos propres outils.

2 endpoints

Système

Endpoints de disponibilité et de limite de débit pour surveiller votre intégration sans consommer votre quota de requêtes.

Référence complète

Exemples de requêtes et de réponses pour chaque endpoint, codes d'erreur et détails d'authentification.

Parcourir la référence de l'API
Démarrage rapide

Comment démarrer avec l'API InboxWarm ?

Vous pouvez effectuer votre premier appel à l'API InboxWarm en moins de 5 minutes : inscrivez-vous, générez une clé API et envoyez une requête curl — sans flux OAuth, sans SDK à installer.

  1. 1

    Créez un compte InboxWarm — l'essai gratuit de 10 jours ne nécessite aucune carte bancaire.

  2. 2

    Générez une clé API depuis Developer Kit > API Integration dans l'application.

  3. 3

    Appelez n'importe quel endpoint — par exemple, listez vos comptes email connectés :

GET /email-accounts
curl "https://app.inboxwarm.ai/api/v1/email-accounts?api_key=YOUR_API_KEY"

C'est tout — la réponse est une liste JSON de vos boîtes de réception avec leur état de warmup. À partir de là, démarrez le warmup avec une seule requête POST.

Authentification

Comment s'authentifier auprès de l'API InboxWarm ?

Chaque requête est authentifiée avec votre clé API ; son emplacement dépend de la méthode HTTP utilisée.

GET / DELETE

Paramètre de requête

Ajoutez votre clé API à l'URL via le paramètre de requête api_key.

?api_key=YOUR_API_KEY
POST

Champ du corps JSON

Incluez votre clé API via le champ apiKey dans le corps de la requête JSON.

{ "apiKey": "YOUR_API_KEY", ... }

Générez et gérez vos clés API depuis Developer Kit > API Integration dans l'application InboxWarm. Chaque clé donne un accès complet au compte sur tous les endpoints.

Cas d'usage

Que pouvez-vous construire avec l'API InboxWarm ?

Les équipes utilisent l'API de délivrabilité email InboxWarm pour intégrer le warmup et le suivi des boîtes de réception dans leurs produits, pipelines BI et flux de travail d'agence — voici trois cas d'usage courants.

1

Déclenchez le warmup depuis votre parcours d'onboarding

Lorsque votre produit provisionne une nouvelle boîte d'envoi pour un client, appelez POST /email-accounts pour la connecter puis POST /warmup-settings/{id}/start pour démarrer automatiquement le warmup — la boîte est déjà en warmup avant que votre client ait terminé son onboarding.

2

Extrayez les scores hebdomadaires de délivrabilité vers votre outil BI

Planifiez une tâche hebdomadaire qui appelle POST /deliverability-score/{id} et POST /reports/bulk, puis envoyez les taux boîte de réception/spam vers Looker, Metabase ou Google Sheets pour que toute votre équipe voie les tendances de délivrabilité aux côtés des métriques de campagne.

3

Surveillez les boîtes de vos clients depuis le tableau de bord de votre agence

Les agences gérant des dizaines de boîtes clients utilisent POST /email-accounts/bulk-status et GET /dashboard pour afficher les erreurs d'authentification, les scores de santé et les états de warmup dans une seule vue interne — et POST /warmup-settings/bulk-action pour corriger les problèmes en masse.

Limites de débit et tarifs

Quelles sont les limites de débit, et combien coûte l'API ?

La limite de débit par défaut est de 20 requêtes par minute et par clé API, et l'accès à l'API est inclus dans tous les forfaits InboxWarm sans coût supplémentaire.

20 req/min

Limite par défaut par clé API. Vérifiez l'utilisation en direct à tout moment via GET /rate-limit — cet appel ne compte pas dans votre quota.

0 $ supplémentaire

L'accès à l'API est inclus dans tous les forfaits — pas de palier API séparé, pas de frais d'utilisation, pas de module payant. Voir les tarifs.

FAQ

Foire aux questions

Oui. InboxWarm dispose d'une API REST publique avec 27 endpoints répartis en 5 catégories : Comptes email, Warmup, Délivrabilité, Rapports et Système. Elle est disponible pour chaque client, sur chaque forfait, sans coût supplémentaire.

Inscrivez-vous à InboxWarm (essai gratuit de 10 jours, sans carte bancaire), puis ouvrez Developer Kit > API Integration dans l'application pour générer et gérer vos clés API. Chaque clé donne un accès complet au compte sur tous les endpoints.

Vous pouvez connecter et gérer des comptes email, démarrer et arrêter le warmup, consulter les paramètres de warmup, vérifier les scores de configuration et de délivrabilité, effectuer des contrôles de santé DNS, et extraire des rapports quotidiens de warmup ainsi que des résumés de tableau de bord vers vos propres outils.

InboxWarm utilise un schéma d'authentification mixte basé sur la méthode HTTP : les requêtes GET et DELETE envoient votre clé API via le paramètre de requête api_key, tandis que les requêtes POST l'envoient via un champ apiKey dans le corps JSON. Aucun flux OAuth n'est requis.

La limite de débit par défaut est de 20 requêtes par minute et par clé API. Vous pouvez vérifier votre utilisation actuelle à tout moment avec GET /rate-limit — cet appel ne compte pas dans votre quota.

L'accès à l'API est inclus dans tous les forfaits InboxWarm sans coût supplémentaire. Il n'existe pas de palier API séparé, de frais d'utilisation ni d'option payante.

Oui. InboxWarm propose une collection Postman avec un serveur simulé (mock) vous permettant d'explorer et de tester chaque endpoint avant d'écrire la moindre ligne de code. Vous la trouverez aux côtés de vos clés API dans Developer Kit > API Integration, dans l'application.

La référence complète, endpoint par endpoint, des 27 endpoints est disponible publiquement sur https://inboxwarm.ai/api/docs/ — aucune connexion requise.

Oui. Utilisez POST /warmup-settings/{emailAccountId}/start et POST /warmup-settings/{emailAccountId}/stop pour contrôler le warmup d'une seule boîte de réception, ou POST /warmup-settings/bulk-action pour démarrer ou arrêter le warmup de jusqu'à 50 boîtes en un seul appel.

Oui. L'API inclut des endpoints en masse pour la connexion de comptes (jusqu'à 20 boîtes), le démarrage/arrêt du warmup (jusqu'à 50 boîtes), le statut des comptes (jusqu'à 50 boîtes), la suppression de comptes (jusqu'à 20 boîtes) et les rapports quotidiens (jusqu'à 50 boîtes par requête).

Prêt à automatiser votre warmup d'email ?

Obtenez votre clé API en quelques minutes — 27 endpoints, essai gratuit de 10 jours, sans carte bancaire, et accès API inclus dans tous les forfaits.