ArgorantDocs

Update campaign settings

patchhttps://app.argorant.com/api/v1/campaigns/{campaign_id}
PATCH
/api/v1/campaigns/{campaign_id}

Change any setting; only the fields you send change. daily_limit is campaign-wide per day, per_mailbox_daily_limit caps each sender, max_active_mailboxes limits rotation. timezone is an IANA name; timezone_mode is fixed (campaign timezone) or lead (each recipient's local time). window_start/window_end are HH:MM. gap_minutes_min/max is the random pause between two sends from the same mailbox. include_unsubscribe adds the opt-out line. Campaigns send plain text; plain_text: false is rejected.

Authorization

BearerAuth
AuthorizationBearer <token>

Your API key from app.argorant.com/profile, sent as Authorization: Bearer <key>.

In: header

Path Parameters

campaign_id*string

Campaign id.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

Shell
curl -X PATCH "https://app.argorant.com/api/v1/campaigns/7f3a2c1e-9b4d-4e8a-a1c2-5d6e7f8a9b0c" \  -H "Content-Type: application/json" \  -d '{    "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,    "include_unsubscribe": true,    "planned_start_date": "2026-10-01",    "tags": [      "q4",      "cfo"    ]  }'
JSON
{  "campaign": {    "id": "7f3a2c1e-9b4d-4e8a-a1c2-5d6e7f8a9b0c",    "name": "Q4 CFO outreach",    "status": "draft",    "settings": {      "daily_limit": 40,      "per_mailbox_daily_limit": 20,      "max_active_mailboxes": null,      "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,      "plain_text": true,      "include_unsubscribe": true,      "planned_start_date": "2026-10-01",      "schedule_days_ahead": 5,      "tags": [        "q4",        "cfo"      ]    }  },  "changed": [    "daily_limit",    "sending_window_start",    "tags"  ]}