キャンペーンを最初から最後まで
キャンペーンを作成し、メールを書き、リストを追加し、メールボックスを選んで開始します。各ステップは1回の呼び出しで完了し、開始するまでは何も送信されません。
launchを呼び出すまで、何も送信されません。同じステップはコマンドラインのコマンドとMCPツールにも用意されているため、エージェントが一連の流れをすべて実行し、開始前にユーザーに確認できます。各呼び出しにIdempotency-Keyヘッダーを付けて送れば、再試行しても処理が二重に行われることはありません。
メールボックスが接続されているか確認する
curl "https://app.argorant.com/api/v1/inboxes" -H "Authorization: Bearer $ARGORANT_API_KEY"メールボックスがまだない場合は、Google Workspaceを1ステップで接続する(ガイド)、アプリでMicrosoft 365を接続する、またはその他のプロバイダーのメールボックスをサーバー設定で接続する(ガイド)ことができます。
設定を指定してキャンペーンを作成する
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"]
}'必須なのはnameだけで、すべての設定はあとからPATCH /api/v1/campaigns/{id}で変更できます。timezone_mode: "lead"を指定すると、各人の現地時間で送信します。キャンペーンはプレーンテキストで送信され、これが受信トレイに最も届きやすい形式です。include_unsubscribeをtrueに設定しない限り、配信停止の行は入りません。
シーケンスを書く
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}
]}'最初のメールには件名が必要です。フォローアップは既定で同じスレッドに続き、前のメールからdelay_days日待って送られます。{{first_name}}、{{last_name}}、{{company}}、{{company_normalized}}(普段呼ばれている企業名)、{{title}}のほか、人物と一緒に送った任意の列({{plan}}など)を使えます。{a|b}と書くと、人ごとに言い回しを変えられます。メールにvariantsを追加すると別のバージョンを用意でき、それらは順番に送られます。人ごとの個別の一文はPUT /api/v1/campaigns/{id}/personalizationで設定します。200人を見つけてメールを送るを参照してください。
リストを登録する
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}または、email、first_name、last_name、company、titleと独自の任意の列を含むrowsを送ります。すべてのアドレスは、追加される前にチェックされます。確認できないアドレスがリストに含まれる場合、最初の応答でどれを追加するかを尋ねられます(needs_choice)。"grades": ["valid"](推奨)または["valid", "catch_all"]を付けて再度呼び出してください。Argorantのデータから追加する人物は、初回に1人あたり1クレジットかかります。独自の行は無料です。個人のアドレス(フリーメールや家庭用インターネットのアドレス)もほかのアドレスと同じように追加されます。業務用メールだけにするには"exclude_private_emails": trueを送ります。
送信元を設定する
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}'または、特定のemailsを指定します。メールは各メールボックスの1日の上限の範囲内で、メールボックス全体に分散して送られます。
開始する
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は空です。開始する前にPOST /api/v1/campaigns/{id}/test-emailを使うと、サンプルのコンタクトで内容を埋めたメールのテストを1通あなた宛てに送れます。開始するのは、ユーザーが了承してからにしてください。pauseは一時停止、stopは終了、DELETEは実行中でないキャンペーンを削除します。
進行状況を確認する
GET /api/v1/campaigns/{id}/analytics?days=30は、日ごとの数値(送信数、返信、前向きな返信、バウンス、配信停止)を合計と率とともに返します。GET /api/v1/campaigns/{id}にはリアルタイムの件数が含まれます。GET /api/v1/campaigns/{id}/leads?status=repliedは返信した人の一覧を、GET /api/v1/campaigns/{id}/repliesはそのメッセージを返します。すべてのキャンペーンをまたいだ返信には受信トレイを使ってください。GET /api/v1/campaigns/{id}/sendersは、そのキャンペーンを送信しているメールボックスとそのステータスを一覧表示します。
実行中のキャンペーンの人物を変更する
POST /api/v1/campaigns/{id}/leads/removeは、ステータス、返信の有無、バウンス、メールのドメイン、タグ、アドレス、保存済みのリストで選んだ多くの人物をまとめて外します。先に"preview": trueを送って、何人が対象になるか確認してください。すでにメールを受け取った人は、"include_contacted": trueを送らない限り残ります。大規模な追加や削除はバックグラウンドで実行されます。応答はジョブを含む202で、GET /api/v1/campaigns/{id}/lead-jobs/{job_id}で進み具合を確認できます。
多くの人物の個別の一文は、1つのファイルにまとめます。POST /api/v1/campaigns/{id}/leads/custom-fields/importは、最大200,000行(50 MB)のCSV、JSON、NDJSONファイルを受け付けます。すでに一文がある人物はそのまま保持され、その行とともに一覧に示されます。修正するには?overwrite=trueを付けてアップロードします。clear列(JSONではnull)を使うと一文が削除され、その人には再び代替の文が使われます。置き換えられた一文はすべて、変更前と変更後の両方が応答に含まれます。
フォルダー
GET /api/v1/foldersはフォルダーを一覧表示し、POST /api/v1/foldersはフォルダーを作成し、PATCH /api/v1/folders/{id}は名前を変更します。POST /api/v1/campaigns/{id}/folderにfolder_idを指定するとキャンペーンをフォルダーに入れ、nullを指定するとフォルダーから出します。フォルダーはキャンペーンを整理するだけで、送信には影響しません。
メールボックスとブロックリスト
GET /api/v1/inboxesは、ドメイン、ステータス、タグ、プロバイダーで絞り込んでメールボックスを一覧表示します。PATCH /api/v1/inboxes/{email}は、メールボックスの1日の上限、ウォームアップ、送信の可否、名前、タイムゾーンを設定し、DELETEは接続を解除します。POST /api/v1/inboxes/updateは、ドメイン、タグ、ステータス、アドレスで選んだ多くのメールボックスに同じ変更をまとめて適用します。既定ではプレビューのみで、"preview": falseを送るまで何も変更しません。POST /api/v1/blocklistにアドレスまたはドメインを指定すると、ワークスペース内からそのアドレスやドメインへのメールがすべて止まります。DELETE /api/v1/blocklist/{id}で解除できます。
ターミナルでの同じ手順
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