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}/labelsAutorisierung
AuthorizationBearer-Token · headererforderlichA BillionSend API key (bs_…).
Pfadparameter
inbox_idstringerforderlichThe inbox ID or its email address, such as support@example.com
Request-Body
erforderlichapplication/jsonnamestringerforderlich1-64 characters, unique in the inbox regardless of case
colorstring#RRGGBB; a color is picked when omitted
Antworten
201
Label created
idstring<uuid>erforderlichnamestringerforderlichcolorstringerforderlichUppercase #RRGGBB
created_atstringerforderlichobjectstringerforderlichErlaubt:
inbox_label401
Missing, malformed, unknown or revoked API key
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlich404
Not found
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlich422
Validation error, a duplicate name or the 100-label cap
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlich429
Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlich