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}/labelsAutorisation
AuthorizationJeton Bearer · headerrequisA BillionSend API key (bs_…).
Paramètres de chemin
inbox_idstringrequisThe inbox ID or its email address, such as support@example.com
Corps de la requête
requisapplication/jsonnamestringrequis1-64 characters, unique in the inbox regardless of case
colorstring#RRGGBB; a color is picked when omitted
Réponses
201
Label created
idstring<uuid>requisnamestringrequiscolorstringrequisUppercase #RRGGBB
created_atstringrequisobjectstringrequisValeurs autorisées :
inbox_label401
Missing, malformed, unknown or revoked API key
statusCodenumberrequisnamestringrequismessagestringrequis404
Not found
statusCodenumberrequisnamestringrequismessagestringrequis422
Validation error, a duplicate name or the 100-label cap
statusCodenumberrequisnamestringrequismessagestringrequis429
Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberrequisnamestringrequismessagestringrequis