Kampagnen von Anfang bis Ende

Kampagne anlegen, E-Mails schreiben, eine Liste hinzufügen, Postfächer wählen und starten. Jeder Schritt ist ein Aufruf, und vor dem Start wird nichts versendet.

Nichts wird versendet, bis du launch aufrufst. Dieselben Schritte gibt es als Befehle auf der Kommandozeile und als MCP-Tools. Ein Agent kann also den ganzen Ablauf erledigen und den Nutzer vor dem Start fragen. Schick bei jedem Aufruf einen Header Idempotency-Key mit, damit eine Wiederholung die Arbeit nie doppelt macht.

Prüfen, ob ein Postfach verbunden ist

Shell

curl "https://app.argorant.com/api/v1/inboxes" -H "Authorization: Bearer $ARGORANT_API_KEY"

Noch kein Postfach? Verbinde einen Google Workspace in einem Schritt (Anleitung), Microsoft 365 in der App oder ein Postfach von einem beliebigen anderen Anbieter mit seinen Servereinstellungen (Anleitung).

Die Kampagne mit ihren Einstellungen anlegen

Shell

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"]
  }'

Nur name ist Pflicht, und jede Einstellung lässt sich später mit PATCH /api/v1/campaigns/{id} ändern. timezone_mode: "lead" versendet in der Ortszeit jeder Person. Kampagnen versenden Klartext, der am besten im Posteingang ankommt. Es gibt keine Abmeldezeile, außer du setzt include_unsubscribe auf true.

Die Sequenz schreiben

Shell

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}
  ]}'

Die erste E-Mail braucht einen Betreff. Follow-ups bleiben standardmäßig im selben Verlauf und warten delay_days nach der vorherigen. Du kannst {{first_name}}, {{last_name}}, {{company}}, {{company_normalized}} (der Name, wie man ihn im Alltag sagt), {{title}} und jede Spalte nutzen, die du mit den Personen geschickt hast, etwa {{plan}}. Schreib {a|b}, um eine Formulierung pro Person zu variieren. Füg einer E-Mail variants für weitere Versionen hinzu. Sie werden abwechselnd versendet. Eine persönliche Zeile pro Person richtest du mit PUT /api/v1/campaigns/{id}/personalization ein, siehe 200 Personen finden und anschreiben.

Die Liste eintragen

Shell

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}

Oder schick deine eigenen rows mit email, first_name, last_name, company, title und beliebigen eigenen Spalten. Jede Adresse wird geprüft, bevor sie dazukommt. Wenn eine Liste Adressen enthält, die sich nicht bestätigen lassen, fragt die erste Antwort, welche du nehmen willst (needs_choice). Ruf dann erneut auf mit "grades": ["valid"] (empfohlen) oder ["valid", "catch_all"]. Personen aus den Daten von Argorant kosten beim ersten Mal 1 Credit pro Person, deine eigenen Zeilen sind kostenlos. Private Adressen (Freemail, privater Internetanschluss) kommen wie alle anderen dazu; sende "exclude_private_emails": true für nur geschäftliche E-Mails.

Die Absender zuordnen

Shell

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}'

Oder nenn bestimmte emails. Die E-Mails werden auf die Postfächer verteilt, jedes innerhalb seines eigenen Tageslimits.

Starten

Shell

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 ist leer, wenn die Kampagne starten kann. Starte erst, nachdem der Nutzer Ja gesagt hat. pause hält sie an, stop beendet sie, und DELETE entfernt eine Kampagne, die nicht läuft.

Den Verlauf beobachten

GET /api/v1/campaigns/{id}/analytics?days=30 liefert die Zahlen pro Tag (versendet, Antworten, positive Antworten, Bounces, Abmeldungen) mit Summen und Quoten. GET /api/v1/campaigns/{id} zeigt die aktuellen Zahlen. GET /api/v1/campaigns/{id}/leads?status=replied listet, wer geantwortet hat, und GET /api/v1/campaigns/{id}/replies liefert ihre Nachrichten. Für Antworten aus allen Kampagnen nimmst du den Posteingang.

Postfächer und die Sperrliste

PATCH /api/v1/inboxes/{email} setzt das Tageslimit eines Postfachs, den Warm-up, ob es versenden darf, seinen Namen oder seine Zeitzone, und DELETE trennt es. POST /api/v1/blocklist mit einer Adresse oder einer Domain stoppt jede E-Mail dorthin in deinem Workspace. DELETE /api/v1/blocklist/{id} hebt das wieder auf.

Dieselben Schritte im Terminal

Shell

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 launch "Q4 CFO"

Kampagnen von Anfang bis Ende

Auf dieser Seite