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}/labelsAuthorization
AuthorizationBearer token · headerrequiredA BillionSend API key (bs_…).
Path parameters
inbox_idstringrequiredThe inbox ID or its email address, such as support@example.com
Request body
requiredapplication/jsonnamestringrequired1-64 characters, unique in the inbox regardless of case
colorstring#RRGGBB; a color is picked when omitted
Responses
201
Label created
idstring<uuid>requirednamestringrequiredcolorstringrequiredUppercase #RRGGBB
created_atstringrequiredobjectstringrequiredAllowed:
inbox_label401
Missing, malformed, unknown or revoked API key
statusCodenumberrequirednamestringrequiredmessagestringrequired404
Not found
statusCodenumberrequirednamestringrequiredmessagestringrequired422
Validation error, a duplicate name or the 100-label cap
statusCodenumberrequirednamestringrequiredmessagestringrequired429
Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberrequirednamestringrequiredmessagestringrequired