Forward a conversation
Forwards the conversation with its history and attachments to up to 10 addresses, from the mailbox that received it. It goes out at once with delivery: checking; within three minutes the conversation shows delivered or rejected with the reason.
| Cost | What it does | Key scopes |
|---|---|---|
| Free | Sends email | argorant:manage_lists |
Authorization
BearerAuth 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
The conversation id from GET /api/v1/inbox.
Header Parameters
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.
length <= 128Your 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.
^[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
curl -X POST "https://app.argorant.com/api/v1/inbox/native-conversation:lead:7f3a2c1e-9b4d-4e8a-a1c2-5d6e7f8a9b0c:0c9d8e7f-6a5b-4c3d-8e2f-1a0b9c8d7e6f/forward" \ -H "Idempotency-Key: 6f1c2e7a-run-42" \ -H "Content-Type: application/json" \ -d '{ "to": [ "sales-lead@northgate-advisory.com" ], "note": "Hot lead, please call her this week." }'{ "ok": true, "forwarded_to": [ "sales-lead@northgate-advisory.com" ], "from": "elena@northgate-advisory.com", "forward_id": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a5b", "delivery": "checking"}