ArgorantDocs

Create a campaign

posthttps://app.argorant.com/api/v1/campaigns
POST
/api/v1/campaigns

Campaign name.

Emails a day for the whole campaign (default 100).

Most emails a day from one mailbox.

Rotate between at most this many mailboxes.

Time zone name, for example Europe/Berlin (default America/New_York).

fixed: the campaign's time zone. lead: each person's local time.

Sending starts, HH:MM (default 08:00).

Sending stops, HH:MM (default 17:00).

No emails on Saturday and Sunday (default true).

Shortest pause between two emails from one mailbox (default 60).

Longest pause (default 120).

Add an unsubscribe link at the end of every email (default false). Offered for campaigns with an unsubscribe page; a reply always works as an opt-out.

Also leave out addresses that bounced for other Argorant users (default true, recommended).

A reply ends that person's emails (default true).

YYYY-MM-DD. A launch before this date waits.

Your own tags.

Pause by itself when bounces are high or the mailboxes are offline.

Bounce share in percent that pauses, 1 to 50 (default 10).

Which email results may join: valid always; add catch_all, unknown or risky to accept them.

Creates a draft. Nothing sends until you launch. Takes every setting of the update call. Defaults: 100 emails a day, 08:00 to 17:00 America/New_York, weekdays only, a pause of 60 to 120 minutes between two emails from one mailbox, plain text, no unsubscribe line.

CostWhat it doesKey scopes
FreeWritesargorant:manage_lists

Authorization

BearerAuth
AuthorizationBearer <token>

Your API key from app.argorant.com/profile, sent as Authorization: Bearer <key>. A connector sign-in token (ag_mcp_...) works the same way.

In: header

Header Parameters

Idempotency-Key?string

Any unique text up to 128 characters. A retry with the same key and the same body within 24 hours returns the first answer (with the header Idempotent-Replayed: true) instead of doing the work twice. The same key with another body answers 409 idempotency_conflict.

Lengthlength <= 128
X-Request-Id?string

Your own id for this request, 8 to 64 letters, digits, dot, dash or underscore. Returned as X-Request-Id; one is made for you when you send none.

Match^[A-Za-z0-9._-]{8,64}$

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

Shell
curl -X POST "https://app.argorant.com/api/v1/campaigns" \  -H "Idempotency-Key: 6f1c2e7a-run-42" \  -H "Content-Type: application/json" \  -d '{    "name": "Q4 CFO outreach",    "daily_limit": 40,    "per_mailbox_daily_limit": 20,    "timezone": "Europe/Berlin",    "window_start": "08:00",    "window_end": "17:00",    "skip_weekends": true,    "include_unsubscribe": false,    "tags": [      "q4"    ]  }'
JSON
{  "campaign": {    "id": "7f3a2c1e-9b4d-4e8a-a1c2-5d6e7f8a9b0c",    "name": "Q4 CFO outreach",    "status": "draft",    "lead_count": 0,    "queued_count": 0,    "sent_count": 0,    "replied_count": 0,    "positive_reply_count": 0,    "bounced_count": 0,    "step_count": 0,    "inbox_count": 0,    "daily_limit": 40,    "default_timezone": "Europe/Berlin",    "created_at": "2026-10-07T09:00:00+00:00",    "updated_at": "2026-10-07T09:00:00+00:00",    "url": "https://app.argorant.com/campaigns/7f3a2c1e-9b4d-4e8a-a1c2-5d6e7f8a9b0c"  },  "next": "Add emails (POST /emails), leads (POST /leads) and senders (POST /senders), then POST /launch."}

Campaigns

Email outreach from start to finish. Create a campaign, write the emails, add people, choose the sending mailboxes and launch. Nothing sends until you launch.

List campaigns GET

Next Page