Les campagnes de bout en bout
Créez la campagne, rédigez les e-mails, ajoutez une liste, choisissez vos boîtes mail et lancez. Chaque étape est un seul appel, et rien n'est envoyé avant le lancement.
Rien n'est envoyé tant que vous n'appelez pas launch. Les mêmes étapes existent en commandes de ligne de commande et en outils MCP, si bien qu'un agent peut dérouler tout le parcours et demander à l'utilisateur avant le lancement. Envoyez un en-tête Idempotency-Key avec chaque appel, pour qu'une nouvelle tentative ne fasse jamais le travail deux fois.
Vérifiez qu'une boîte mail est connectée
curl "https://app.argorant.com/api/v1/inboxes" -H "Authorization: Bearer $ARGORANT_API_KEY"Pas encore de boîte mail ? Connectez un Google Workspace en une étape (guide), Microsoft 365 dans l'app, ou une boîte mail de n'importe quel autre fournisseur avec ses paramètres serveur (guide).
Créez la campagne avec ses paramètres
curl -X POST "https://app.argorant.com/api/v1/campaigns" \
-H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
-d '{
"name": "Q4 CFO outreach",
"daily_limit": 40, "per_mailbox_daily_limit": 20,
"timezone": "Europe/Berlin", "timezone_mode": "fixed",
"window_start": "08:00", "window_end": "17:00", "skip_weekends": true,
"gap_minutes_min": 60, "gap_minutes_max": 120,
"planned_start_date": "2026-10-01", "tags": ["q4"]
}'Seul name est obligatoire, et chaque paramètre peut être modifié plus tard avec PATCH /api/v1/campaigns/{id}. timezone_mode: "lead" envoie à l'heure locale de chaque personne. Les campagnes envoient du texte brut, ce qui arrive le mieux en boîte de réception. Il n'y a pas de ligne de désinscription, sauf si vous mettez include_unsubscribe à true.
Rédigez la séquence
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/emails" \
-H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
-d '{"emails":[
{"subject":"Quick question, {{first_name}}","body":"Hi {{first_name}},\n\nsaw {{company}} is hiring in finance. Worth a 10 minute call?\n\nBest"},
{"body":"Bumping this up in case it got buried.","delay_days":3,"same_thread":true}
]}'Le premier e-mail a besoin d'un objet. Par défaut, les relances restent dans le même fil et attendent delay_days après la précédente. Vous pouvez utiliser {{first_name}}, {{last_name}}, {{company}}, {{company_normalized}} (le nom tel qu'on le dit au quotidien), {{title}} et toute colonne envoyée avec les personnes, comme {{plan}}. Écrivez {a|b} pour varier une formulation d'une personne à l'autre. Ajoutez variants à un e-mail pour d'autres versions ; elles sont envoyées à tour de rôle. Une phrase personnalisée par personne se configure avec PUT /api/v1/campaigns/{id}/personalization ; voir Trouver 200 personnes et leur écrire.
Inscrivez la liste
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/leads" \
-H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
-d '{"list_id": 1240}'
# {"input_rows": 1240, "inserted": 1188, "duplicates_skipped": 12, "skipped_not_valid": 40, "queued_for_verification": 0}Ou envoyez vos propres rows avec email, first_name, last_name, company, title et toute colonne à vous. Chaque adresse est vérifiée avant d'entrer. Quand une liste contient des adresses qui ne peuvent pas être confirmées, la première réponse demande lesquelles prendre (needs_choice) ; rappelez avec "grades": ["valid"] (recommandé) ou ["valid", "catch_all"]. Les personnes issues des données d'Argorant coûtent 1 crédit chacune la première fois ; vos propres lignes sont gratuites. Les adresses privées (messagerie gratuite, fournisseur d'accès Internet) sont ajoutées comme les autres ; envoyez "exclude_private_emails": true pour ne garder que les e-mails professionnels.
Associez les expéditeurs
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/senders" \
-H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
-d '{"all_connected": true}'Ou indiquez des emails précis. Les e-mails sont répartis entre les boîtes mail, chacune dans sa propre limite quotidienne.
Lancez
curl "https://app.argorant.com/api/v1/campaigns/$ID" -H "Authorization: Bearer $ARGORANT_API_KEY" | jq .launch_blockers
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/launch" -H "Authorization: Bearer $ARGORANT_API_KEY"launch_blockers est vide quand la campagne peut partir. Avant le lancement, POST /api/v1/campaigns/{id}/test-email vous envoie un test d'un e-mail, rempli avec un contact d'exemple. Ne lancez qu'après le oui de l'utilisateur. pause la met en attente, stop l'arrête définitivement, et DELETE supprime une campagne qui n'est pas en cours.
Suivre la campagne
GET /api/v1/campaigns/{id}/analytics?days=30 donne les chiffres par jour (envoyés, réponses, réponses positives, rebonds, désinscriptions) avec les totaux et les taux. GET /api/v1/campaigns/{id} donne les compteurs en direct. GET /api/v1/campaigns/{id}/leads?status=replied liste les personnes qui ont répondu, et GET /api/v1/campaigns/{id}/replies donne leurs messages. Pour les réponses de toutes les campagnes, utilisez la boîte de réception. GET /api/v1/campaigns/{id}/senders liste les boîtes mail qui l'envoient, avec leur statut.
Modifier les personnes d'une campagne en cours
POST /api/v1/campaigns/{id}/leads/remove retire beaucoup de personnes d'un coup, choisies par statut, réponse, rebond, domaine d'e-mail, tag, adresses ou liste enregistrée. Envoyez d'abord "preview": true pour voir combien seraient retirées. Les personnes qui ont déjà reçu un e-mail restent, sauf si vous envoyez "include_contacted": true. Un ajout ou un retrait important s'exécute en arrière-plan : la réponse est un 202 avec une tâche, et GET /api/v1/campaigns/{id}/lead-jobs/{job_id} indique où elle en est.
Les phrases personnalisées de nombreuses personnes tiennent dans un seul fichier : POST /api/v1/campaigns/{id}/leads/custom-fields/import accepte un fichier CSV, JSON ou NDJSON de 200 000 lignes au plus (50 Mo). Les phrases déjà présentes sont conservées et listées avec leur ligne. Pour les corriger, envoyez le fichier avec ?overwrite=true ; une colonne clear (ou null en JSON) supprime une phrase, et la personne reçoit de nouveau le texte de repli. Chaque phrase remplacée revient dans la réponse, l'ancienne et la nouvelle.
Dossiers
GET /api/v1/folders liste vos dossiers, POST /api/v1/folders en crée un et PATCH /api/v1/folders/{id} le renomme. POST /api/v1/campaigns/{id}/folder avec un folder_id range une campagne, et null l'en sort. Les dossiers ne servent qu'à trier les campagnes ; l'envoi n'est pas concerné.
Boîtes mail et liste d'exclusion
GET /api/v1/inboxes liste vos boîtes mail, avec des filtres par domaine, statut, tag et fournisseur. PATCH /api/v1/inboxes/{email} règle la limite quotidienne d'une boîte mail, son warm-up, son droit d'envoi, son nom ou son fuseau horaire, et DELETE la déconnecte. POST /api/v1/inboxes/update applique la même modification à de nombreuses boîtes mail d'un coup, choisies par domaine, tag, statut ou adresse ; par défaut il affiche un aperçu et ne change rien tant que vous n'envoyez pas "preview": false. POST /api/v1/blocklist avec une adresse ou un domaine bloque tout e-mail vers celui-ci dans votre espace de travail ; DELETE /api/v1/blocklist/{id} lève ce blocage.
Les mêmes étapes dans le terminal
argorant campaigns create --name "Q4 CFO outreach" --daily-limit 40 --window 08:00-17:00 --timezone Europe/Berlin
argorant campaigns emails set "Q4 CFO" --step 1 --subject "Quick question, {{first_name}}" --body-file step1.txt
argorant campaigns emails set "Q4 CFO" --step 2 --body "Bumping this up." --delay-days 3
argorant campaigns leads add "Q4 CFO" --list 1240
argorant campaigns senders set "Q4 CFO" --all
argorant campaigns test "Q4 CFO" --step 1
argorant campaigns launch "Q4 CFO"
argorant campaigns leads remove "Q4 CFO" --not-replied --domains competitor.com --preview
argorant campaigns folders create --name "Q4"
argorant campaigns move "Q4 CFO" --folder Q4
argorant inboxes update --domains northgate-advisory.com --daily-limit 30Trouver, enregistrer et exporter
Les filtres communs à toutes les recherches, les listes enregistrées, les exports CSV, les numéros de téléphone et l'enrichissement, et ce que coûte chacun.
Tags de campagne
Étiquetez vos campagnes avec des tags, filtrez la liste des campagnes par tag et taguez de nombreuses campagnes à la fois, dans l'app, avec l'API et dans les assistants IA.