Send a reply
ReferenceUpdated November 12, 2026
Send a reply
Send a reply in a lead's existing campaign thread. The message goes out from the mailbox that received the lead's reply, with that reply quoted underneath. This is the same send the Inbox uses.
Requires the inbox:write scope. A key created in Settings with no scope list already has full access. The lead must belong to the API key's workspace. Create the key as described in Getting Started.
list_lead_id comes from the email.replied webhook (data.lead.list_lead_id).
Send a reply
POST /api/v1/replies · scope inbox:write
Body
| Field | Type | Required | Description |
|---|---|---|---|
list_lead_id | string (uuid) | Yes | The lead row from the webhook. |
message | string | Yes | Plain text or HTML. Plain text line breaks are kept. Empty messages are rejected. Max 100,000 characters. |
Example request
curl -X POST "https://app.machfive.co/api/v1/replies" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"list_lead_id": "22222222-2222-2222-2222-222222222222",
"message": "Thanks Ada — does Thursday at 2pm work?"
}'Response (200 OK)
{
"list_lead_id": "22222222-2222-2222-2222-222222222222",
"subject": "Re: Quick question",
"sent_at": "2026-11-12T22:16:04.000Z",
"from_email": "sam@youragency.com",
"from_name": "Sam Rivera"
}| Field | Description |
|---|---|
list_lead_id | The lead you replied to. |
subject | Thread subject the reply was filed under. |
sent_at | When MachFive recorded the send. |
from_email | Mailbox the reply was sent from. Null if the provider did not return one. |
from_name | Sender name, when the provider returned one. |
Errors
| Status | Code | When |
|---|---|---|
| 400 | BAD_REQUEST | Body failed validation, or message has no text. |
| 401 | UNAUTHORIZED | Missing or invalid API key. |
| 403 | FORBIDDEN | Key is missing inbox:write. |
| 404 | NOT_FOUND | Lead is not in this workspace, or sending is off. |
| 409 | CONFLICT | Lead has opted out or unsubscribed. detail.reason is opted_out or unsubscribed. See Opt-outs. |
| 422 | UNPROCESSABLE | No inbound message to reply to, or the sending provider rejected the message. |
Plans are in the Replies overview. Webhook setup and the signature check are in Webhooks.