Create a label
A named, colored tag of one inbox: at most 100, names unique regardless of case. A color is picked when omitted.
POST
/inboxes/{inbox_id}/labelsAutorização
AuthorizationToken Bearer · headerobrigatórioA BillionSend API key (bs_…).
Parâmetros de caminho
inbox_idstringobrigatórioThe inbox ID or its email address, such as support@example.com
Corpo da requisição
obrigatórioapplication/jsonnamestringobrigatório1-64 characters, unique in the inbox regardless of case
colorstring#RRGGBB; a color is picked when omitted
Respostas
201
Label created
idstring<uuid>obrigatórionamestringobrigatóriocolorstringobrigatórioUppercase #RRGGBB
created_atstringobrigatórioobjectstringobrigatórioValores permitidos:
inbox_label401
Missing, malformed, unknown or revoked API key
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatório404
Not found
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatório422
Validation error, a duplicate name or the 100-label cap
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatório429
Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatório