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

FieldTypeRequiredDescription
list_lead_idstring (uuid)YesThe lead row from the webhook.
messagestringYesPlain 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"
}
FieldDescription
list_lead_idThe lead you replied to.
subjectThread subject the reply was filed under.
sent_atWhen MachFive recorded the send.
from_emailMailbox the reply was sent from. Null if the provider did not return one.
from_nameSender name, when the provider returned one.

Errors

StatusCodeWhen
400BAD_REQUESTBody failed validation, or message has no text.
401UNAUTHORIZEDMissing or invalid API key.
403FORBIDDENKey is missing inbox:write.
404NOT_FOUNDLead is not in this workspace, or sending is off.
409CONFLICTLead has opted out or unsubscribed. detail.reason is opted_out or unsubscribed. See Opt-outs.
422UNPROCESSABLENo 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.