ArgorantDocs

Send people to a connected tool

posthttps://app.argorant.com/api/v1/integrations/{integration_id}/pushes
POST
/api/v1/integrations/{integration_id}/pushes

Send the people of one of your Argorant campaigns.

Send the rows of one of your exports. It may still be running.

The campaign in the tool, from GET /api/v1/integrations/{integration_id}/campaigns.

For an export, which email results to send, from valid, catch_all and risky. Default valid.

For a campaign, send only people who were not emailed yet. Default false.

Sends the people of one of your Argorant campaigns, or the rows of one of your exports, into a campaign in the connected tool. Send campaign_id or export_id, not both. People who bounced, unsubscribed or are on your blocklist are never sent. An export that is still being built is fine: the people go as soon as the file is ready. To send a list, export it first (POST /api/v1/lists/{list_id}/export) and send that export. Up to 100,000 people per call. The campaign in the tool is not started and no email is sent. The answer is the push; read its progress with GET /api/v1/integrations/pushes/{push_id}.

CostWhat it doesKey scopes
Free, from the Pro plan. Exports are paid when they run.Writesargorant: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

Path Parameters

integration_id*integer

The connected tool's id from GET /api/v1/integrations.

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

application/json

Shell
curl -X POST "https://app.argorant.com/api/v1/integrations/18/pushes" \  -H "Idempotency-Key: 6f1c2e7a-run-42" \  -H "Content-Type: application/json" \  -d '{    "campaign_id": "7f3a2c1e-9b4d-4e8a-a1c2-5d6e7f8a9b0c",    "target_campaign_id": "3356753",    "only_not_contacted": true  }'
JSON
{  "push_id": "912",  "tool": "sending_tool",  "tool_name": "Your sending tool",  "integration_id": "18",  "source": {    "kind": "campaign",    "id": "7f3a2c1e-9b4d-4e8a-a1c2-5d6e7f8a9b0c"  },  "target_campaign_id": "3356753",  "status": "queued",  "total": 0,  "sent": 0,  "already_there": 0,  "not_accepted": 0,  "message": "Sending to your sending tool.",  "created_at": "2026-10-12T09:00:00+00:00",  "completed_at": null}