Forward an email
BillionSend extension: forwards server-side, inline under a note (default) or with the original attached as forwarded_message.eml (mode: attachment), within 10 MiB. An email that carries malware is never forwarded. Sender rules and the 202 draft answer are those of the reply. Accepts an Idempotency-Key. Needs a full access key.
/emails/receiving/{id}/forwardAuthorizationBearer 令牌 · header必填A BillionSend API key (bs_…).
idstring<uuid>必填Idempotency-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/jsontostring | string[]必填An address or a list of them; "Name <address>" works too
显示属性隐藏属性
stringstring 数组stringccstring | string[]An address or a list of them; "Name <address>" works too
显示属性隐藏属性
stringstring 数组stringbccstring | string[]An address or a list of them; "Name <address>" works too
显示属性隐藏属性
stringstring 数组stringhtmlstringHTML 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
显示属性隐藏属性
object 数组filenamestring | boolean | null显示属性隐藏属性
stringbooleannullcontentstringcontent_typestringcontent_idstringInline part: the HTML shows it with <img src="cid:<content_id>">
pathstringrequires_approvalbooleanBillionSend extension: hold the email as a draft that a person approves (202 with the Draft)
fromstringSender on a verified team domain; defaults to the inbox address the email reached, else the first address it was received for
inbox_idstring<uuid>The inbox to answer from, among those the email reached
modestringinline (default) quotes the original under the note; attachment sends it as forwarded_message.eml
inlineattachmentSent
objectstring必填emailidstring<uuid>必填thread_idstring<uuid> | null必填inbox_idstring<uuid> | null必填Held for approval
objectstring必填inbox_draftidstring<uuid>必填typestring必填standalonereplytostring[] | null必填ccstring[]必填bccstring[]必填subjectstring | null必填htmlstring | null必填textstring | null必填thread_idstring<uuid> | null必填reply_to_email_idstring<uuid> | null必填email_idstring<uuid> | null必填created_atstring必填updated_atstring必填attachmentsobject[]必填The draft's files, by position; empty once it is sent, rejected or expired
显示属性隐藏属性
object 数组idstring必填filenamestring必填content_typestring必填sizeinteger必填statusstring必填draftpending_approvalsentrejectedexpiredapproval_reasonsstring[]必填forwardboolean必填decided_bystring | null必填decided_atstring | null必填expires_atstring | null必填send_atstring | null必填BillionSend extension: when the scheduled send goes out; null when not scheduled
send_errorstring | null必填BillionSend 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
statusCodenumber必填namestring必填messagestring必填Restricted API key, the inbox's or the shared domain's rules, or held mail
statusCodenumber必填namestring必填messagestring必填Not found
statusCodenumber必填namestring必填messagestring必填Idempotency conflict, or a draft already sent
statusCodenumber必填namestring必填messagestring必填Validation error
statusCodenumber必填namestring必填messagestring必填The 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)
statusCodenumber必填namestring必填messagestring必填