Reply to a buyer/inquiry message
beycome_reply_messagePost-publish stage — reply to a buyer/inquiry message (POST /messages/reply).
Sends a real message and queues a real email notification to the recipient, so the text you send is final — treat this as a live send, not a draft.
ALWAYS improve the user's drafted reply before sending: fix grammar, spelling, punctuation, capitalization, and formatting, and tighten wording for a clear, professional tone — while preserving their meaning and intent. Send the corrected version, never the raw draft. When the user says "reply saying X", treat X as a rough draft to polish, not literal text to send verbatim.
Requires to_user_id (the counterparty), message, and access_token.
For a threaded reply pass the original thread verbatim and omit
subject (the server prefixes "Re: "). To find
to_user_id, open the conversation with beycome_messages and take the
participant id that is not the signed-in owner.
Success is 201 with data.id set to the new message id. Failures come back
as 400 with a plain message: "User not found." (bad to_user_id), "You
cannot send a message to yourself." (to_user_id is the sender), or
"Invalid parameters" (e.g. empty/over-long message). A 401 means the
token is no longer valid — re-authenticate with beycome_signin_start then
beycome_signin_verify.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| thread | No | Thread id from the original conversation (a `beycome_messages` row's ``thread``). Pass it verbatim to keep the reply stitched to the thread. | |
| message | Yes | The reply text to send (max 5000 chars). | |
| subject | No | Optional subject (max 255). Omit on a thread reply — the server derives "Re: <original subject>". | |
| to_user_id | Yes | Recipient's beycome user id — the counterparty in the thread (the ``fromuser``/``touser`` from a `beycome_messages` row that is NOT the signed-in owner). Cannot be the sender's own id. | |
| access_token | Yes | Bearer access token from beycome_signin_verify, or a previously saved token from your memory for this user. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||