Send a batch of emails
/emails/batchAuthorizationToken Bearer · headerobligatorioA BillionSend API key (bs_…).
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.
x-batch-validationstringstrict (default): any invalid email rejects the whole batch with that email's error, sending nothing. permissive: invalid emails are listed in errors by index and the valid ones are sent.
strictpermissiveapplication/jsonSendEmailRequestfromstringobligatorioSender, "Name <user@domain>" or bare address; the domain must be verified for the team
tostring | string[]obligatorioRecipient address or list of up to 50
Mostrar propiedadesOcultar propiedades
stringstringstringsubjectstringobligatorioSubject line
htmlstringHTML body; at least one of html/text is required
textstringPlain-text body; at least one of html/text is required
ccstring | string[]Cc address or list
Mostrar propiedadesOcultar propiedades
stringstringstringbccstring | string[]Bcc address or list
Mostrar propiedadesOcultar propiedades
stringstringstringreply_tostring | string[]Reply-To address or list
Mostrar propiedadesOcultar propiedades
stringstringstringscheduled_atstringDeliver later: ISO 8601 with offset, or relative like "in 2 hours" (an ISO 8601 datetime with offset (e.g. "2026-09-01T12:00:00Z") or a relative time like "in 5 mins", "in 2 hours", or "in 1 day"); max 30 days ahead
tagsobject[]Key/value labels attached to the email for filtering; names starting with billionsend_, in any letter case, are reserved
Mostrar propiedadesOcultar propiedades
objectnamestringobligatoriovaluestringobligatoriotopic_idstring<uuid> | nullTopic id: recipients opted out of the topic are skipped; a send to one address that is a contact also gets that contact's unsubscribe link. A topic bound to a domain (domain_id) can be sent only from that domain (422 otherwise)
attachmentsobject[]Attachments with base64 content (no remote paths)
Mostrar propiedadesOcultar propiedades
objectfilenamestring | boolean | nullMostrar propiedadesOcultar propiedades
stringbooleannullcontentstringcontent_typestringcontent_idstringInline part: the HTML shows it with <img src="cid:<content_id>">
pathstringheadersobjectExtra message headers (transport headers are rejected)
templateanyNot supported: any value is a 422; an email takes html and/or text
Batch accepted
dataobject[]obligatorioMostrar propiedadesOcultar propiedades
objectidstring<uuid>obligatorioerrorsobject[]Mostrar propiedadesOcultar propiedades
objectindexintegerobligatoriomessagestringobligatorioIdempotency-Key is not 1 to 256 characters
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorioMissing, malformed, unknown or revoked API key
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorioRestricted API key
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorioNot found
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorioIdempotency conflict
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorioValidation error
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorioSending quota exceeded, or the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorio