ArgorantDocs

Campagnes van begin tot eind

Maak de campagne aan, schrijf de e-mails, voeg een lijst toe, kies je mailboxen en start. Elke stap is één aanroep, en er wordt niets verstuurd vóór de start.

Er wordt niets verstuurd tot je launch aanroept. Dezelfde stappen bestaan als command line-opdrachten en als MCP-tools, dus een agent kan de hele flow uitvoeren en de gebruiker vóór de start om akkoord vragen. Stuur bij elke aanroep een Idempotency-Key-header mee, zodat een nieuwe poging het werk nooit twee keer doet.

Controleer dat er een mailbox gekoppeld is

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

Nog geen mailbox? Koppel een Google Workspace in één stap (gids), Microsoft 365 in de app, of een mailbox van elke andere aanbieder met zijn serverinstellingen (gids).

Maak de campagne aan met haar instellingen

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

Alleen name is verplicht, en elke instelling kun je later wijzigen met PATCH /api/v1/campaigns/{id}. timezone_mode: "lead" verstuurt in de lokale tijd van elke persoon. Campagnes versturen platte tekst, die het best in de inbox aankomt. Er is geen afmeldregel, tenzij je include_unsubscribe op true zet.

Schrijf de reeks

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

De eerste e-mail heeft een onderwerp nodig. Follow-ups blijven standaard in hetzelfde gesprek en wachten delay_days na de vorige. Je kunt {{first_name}}, {{last_name}}, {{company}}, {{company_normalized}} (de naam die mensen zeggen), {{title}} en elke kolom gebruiken die je met de mensen hebt meegestuurd, zoals {{plan}}. Schrijf {a|b} om een formulering per persoon te laten variëren. Voeg variants toe aan een e-mail voor andere versies; die worden om de beurt verstuurd. Een persoonlijke zin per persoon stel je in met PUT /api/v1/campaigns/{id}/personalization; zie 200 mensen vinden en mailen.

Zet de lijst in de campagne

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}

Of stuur je eigen rows met email, first_name, last_name, company, title en elke eigen kolom. Elk adres wordt gecontroleerd voordat het erbij komt. Bevat een lijst adressen die niet kunnen worden bevestigd, dan vraagt het eerste antwoord welke je wilt nemen (needs_choice); roep dan opnieuw aan met "grades": ["valid"] (aanbevolen) of ["valid", "catch_all"]. Mensen uit de gegevens van Argorant kosten de eerste keer 1 credit per persoon; je eigen rijen zijn gratis. Privéadressen (gratis mail, internet thuis) worden toegevoegd zoals alle andere; stuur "exclude_private_emails": true voor alleen zakelijke e-mailadressen.

Koppel de afzenders

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

Of noem specifieke emails. E-mails worden over de mailboxen verdeeld, elk binnen zijn eigen daglimiet.

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 is leeg als de campagne kan starten. Vóór de start stuurt POST /api/v1/campaigns/{id}/test-email één test van een e-mail naar jou, ingevuld met een voorbeeldcontact. Start pas nadat de gebruiker ja heeft gezegd. pause zet hem stil, stop beëindigt hem, en DELETE verwijdert een campagne die niet loopt.

Volg de voortgang

GET /api/v1/campaigns/{id}/analytics?days=30 geeft de dagelijkse cijfers (verstuurd, antwoorden, positieve antwoorden, bounces, afmeldingen) met totalen en percentages. GET /api/v1/campaigns/{id} heeft de actuele aantallen. GET /api/v1/campaigns/{id}/leads?status=replied toont wie heeft geantwoord, en GET /api/v1/campaigns/{id}/replies geeft hun berichten. Voor antwoorden uit alle campagnes gebruik je de inbox. GET /api/v1/campaigns/{id}/senders toont de mailboxen die de campagne versturen, met hun status.

De mensen in een lopende campagne wijzigen

POST /api/v1/campaigns/{id}/leads/remove haalt veel mensen tegelijk weg, gekozen op status, geantwoord, gebounced, e-maildomein, tag, adressen of een opgeslagen lijst. Stuur eerst "preview": true om te zien hoeveel er zouden verdwijnen. Mensen die al een e-mail hebben gekregen, blijven, tenzij je "include_contacted": true stuurt. Een grote toevoeging of verwijdering loopt op de achtergrond: het antwoord is 202 met een job, en GET /api/v1/campaigns/{id}/lead-jobs/{job_id} laat zien hoe ver die is.

Persoonlijke zinnen voor veel mensen gaan in één bestand: POST /api/v1/campaigns/{id}/leads/custom-fields/import neemt een CSV-, JSON- of NDJSON-bestand met tot 200.000 rijen (50 MB). Zinnen die mensen al hebben, blijven behouden en worden met hun rij vermeld. Wil je ze corrigeren, upload dan met ?overwrite=true; een kolom clear (of null in JSON) haalt een zin weg, en de persoon krijgt weer de terugvaloptie. Elke vervangen zin komt terug in het antwoord, oud en nieuw.

Mappen

GET /api/v1/folders toont je mappen, POST /api/v1/folders maakt er een aan en PATCH /api/v1/folders/{id} geeft hem een nieuwe naam. POST /api/v1/campaigns/{id}/folder met een folder_id zet een campagne in een map, en null haalt hem er weer uit. Mappen sorteren alleen campagnes; het versturen verandert er niet door.

Mailboxen en de blokkeerlijst

GET /api/v1/inboxes toont je mailboxen met filters voor domein, status, tag en aanbieder. PATCH /api/v1/inboxes/{email} stelt de daglimiet van een mailbox in, de warm-up, of hij mag versturen, zijn naam of zijn tijdzone, en DELETE ontkoppelt hem. POST /api/v1/inboxes/update voert dezelfde wijziging uit voor veel mailboxen tegelijk, gekozen op domein, tag, status of adres; standaard krijg je een voorbeeld en er verandert niets tot je "preview": false stuurt. POST /api/v1/blocklist met een adres of een domein stopt elke e-mail daarheen in je workspace; DELETE /api/v1/blocklist/{id} heft dat weer op.

Dezelfde stappen in de 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 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 30

Op deze pagina