Update an inbox
Its name or from_name; BillionSend extension: expires_in, a new lifetime counted from now. On a shared-domain inbox a new from_name is reviewed first (503 while that review is unavailable). Returns the full inbox.
/inboxes/{inbox_id}AuthorizationToken Bearer · headerobrigatórioA BillionSend API key (bs_…).
inbox_idstringobrigatórioThe inbox ID or its email address, such as support@example.com
application/jsonnamestringfrom_namestring"" removes it. On the shared domain a new one may not imitate a brand, and it is reviewed first where the instance reviews names (503 with retry-after while that review is unavailable).
expires_instring | nullBillionSend extension: a new lifetime counted from now, "1h" to "365d"; null never expires
Inbox updated
objectstringobrigatórioinboxidstring<uuid>obrigatórionamestringobrigatórioemail_addressstringobrigatóriodomain_idstring<uuid>obrigatórioA shared address's is its team's shared subdomain: the GET /domains row with shared: true
receiving_addressstring | nullobrigatóriofrom_namestring | nullobrigatóriounreadintegerobrigatórioThreads with an unread message
draftsintegerobrigatórioUnsent drafts
last_receivedstring | nullobrigatóriocreated_atstringobrigatórioupdated_atstringobrigatóriokindstringobrigatórioagenthumansharedbooleanobrigatórioOn the shared inbox domain
expires_atstring | nullobrigatórioquarantinedintegerobrigatórioHeld messages not yet released
pending_approvalintegerobrigatórioDrafts waiting for a person
Missing, malformed, unknown or revoked API key
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatórioNot found
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatórioValidation error
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatórioToo many names reviewed or refused on the shared domain today, or the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatórioA new from_name on the shared domain can't be reviewed right now; retry-after says when to try again
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatório