Add leads

Server URLloading...

POST

/api/v1/campaigns/{campaign_id}/leads

Send

Authorization

BearerAuth

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

Authorization (Header)string

Path

campaign_id*string

Body

rowsarray, JSON[ { "email": "jane.doe@example-acme.com", "first_name": "Jane", "last_name": "Doe", "company": "Acme", "title": "CFO" } ]

include_catch_allboolean

false

 Not senttruefalse

Enroll a saved list (list_id) or explicit rows. Every address is verified before it joins; only valid ones are enrolled unless include_catch_all is true. Addresses without a verdict yet are checked in the background and enrolled automatically. Duplicates, blocklisted and suppressed addresses are skipped. Any extra key on a row (plan, city, last_order …) is stored with the lead and usable in emails as {{plan}}.

Use list_id (from a saved list) instead of rows to enroll a whole list.

Path Parameters

Response Body

curl -X POST "https://app.argorant.com/api/v1/campaigns/7f3a2c1e-9b4d-4e8a-a1c2-5d6e7f8a9b0c/leads" \  -H "Content-Type: application/json" \  -d '{    "rows": [      {        "email": "jane.doe@example-acme.com",        "first_name": "Jane",        "last_name": "Doe",        "company": "Acme",        "title": "CFO"      }    ],    "include_catch_all": false  }'

{  "ok": true,  "input_rows": 1240,  "inserted": 1188,  "duplicates_skipped": 12,  "skipped_not_valid": 40,  "queued_for_verification": 0,  "verification_counts": {    "valid": 1188,    "catch_all": 28,    "invalid": 12,    "unknown": 0  }}