Forward a thread email
Forwards the email from the inbox address, quoted under “––––– Forwarded message ———” with its From, Date, Subject and To, after an optional note. Its attachments go along, with any attachments you add, within 10 MiB in all. An email that carries malware is never forwarded. Accepts an Idempotency-Key; a forward the inbox’s rules hold answers 202 with the Draft.
/inboxes/{inbox_id}/threads/{thread_id}/emails/{email_id}/forwardAuthorizationBearer-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/jsontostring | string[]erforderlichAn address or a list of them; "Name <address>" works too
Eigenschaften anzeigenEigenschaften ausblenden
stringstringstringccstring | 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
stringstringstringhtmlstringHTML 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>">
pathstringrequires_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