Reply in a thread
Replies from the inbox address in the thread, with In-Reply-To and References set: to the email’s Reply-To or sender (or, for an email the inbox sent, its recipients), plus everyone else on it with reply_all. Bcc is never copied. Takes attachments as POST /emails does. Accepts an Idempotency-Key. When the inbox’s rules hold the reply (or requires_approval is true) it is kept as a draft for a person to approve and the answer is 202 with the Draft.
/inboxes/{inbox_id}/threads/{thread_id}/emails/{email_id}/replyAuthorizationBearer-Token · headererforderlichA BillionSend API key (bs_…).
inbox_idstringerforderlichThe inbox ID or its email address, such as support@example.com
thread_idstring<uuid>erforderlichemail_idstring<uuid>erforderlichIdempotency-Keystring1 to 256 characters. A retry with the same key and the same body answers the original response instead of sending again; the same key with a different body answers 409 invalid_idempotent_request.
application/jsonhtmlstringHTML body
textstringPlain-text body
subjectstring1-2000 characters on one line; defaults to the thread subject with Re: or Fwd:
attachmentsobject[] | nullFiles with base64 content (no remote paths), 10 MiB decoded in all; none on the shared domain. A held send keeps them with its draft
Eigenschaften anzeigenEigenschaften ausblenden
objectfilenamestring | boolean | nullEigenschaften anzeigenEigenschaften ausblenden
stringbooleannullcontentstringcontent_typestringcontent_idstringInline part: the HTML shows it with <img src="cid:<content_id>">
pathstringccstring | string[]An address or a list of them; "Name <address>" works too
Eigenschaften anzeigenEigenschaften ausblenden
stringstringstringbccstring | string[]An address or a list of them; "Name <address>" works too
Eigenschaften anzeigenEigenschaften ausblenden
stringstringstringreply_allbooleanAlso copy the message's other recipients (cc), never its bcc
requires_approvalbooleanBillionSend extension: hold the email as a draft that a person approves (202 with the Draft)
headersanyNot supported: only an empty value is accepted, anything else answers 422
Sent
idstring<uuid>erforderlichThe ID of the sent email: GET /emails/{id} reads it
thread_idstring<uuid> | nullerforderlichBillionSend extension: the thread the email was sent in
Held for approval
objectstringerforderlichinbox_draftidstring<uuid>erforderlichtypestringerforderlichstandalonereplytostring[] | nullerforderlichccstring[]erforderlichbccstring[]erforderlichsubjectstring | nullerforderlichhtmlstring | nullerforderlichtextstring | nullerforderlichthread_idstring<uuid> | nullerforderlichreply_to_email_idstring<uuid> | nullerforderlichemail_idstring<uuid> | nullerforderlichcreated_atstringerforderlichupdated_atstringerforderlichattachmentsobject[]erforderlichThe draft's files, by position; empty once it is sent, rejected or expired
Eigenschaften anzeigenEigenschaften ausblenden
objectidstringerforderlichfilenamestringerforderlichcontent_typestringerforderlichsizeintegererforderlichstatusstringerforderlichdraftpending_approvalsentrejectedexpiredapproval_reasonsstring[]erforderlichforwardbooleanerforderlichdecided_bystring | nullerforderlichdecided_atstring | nullerforderlichexpires_atstring | nullerforderlichsend_atstring | nullerforderlichBillionSend extension: when the scheduled send goes out; null when not scheduled
send_errorstring | nullerforderlichBillionSend extension: the error name of the last scheduled send that was refused (e.g. invalid_api_key, inbox_send_cap_reached, not_found); null otherwise
Missing, malformed, unknown or revoked API key
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlichRestricted API key, the inbox's or the shared domain's rules, or held mail
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlichNot found
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlichIdempotency conflict, or a draft already sent
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlichValidation error
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlichThe inbox's daily send limit, or the team's daily limit for mail from the shared domain, or the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlich