Create a template
POST
/templates授权
AuthorizationBearer 令牌 · header必填A BillionSend API key (bs_…).
请求体
必填application/jsonnamestring必填最小长度 1 · 最大长度 200
subjectstring | null"" or null clears the subject
最大长度 998
htmlstring必填Stored as sent; the dashboard sanitizes at render
最小长度 1 · 最大长度 500000
textstring | null"" or null clears the text part
最大长度 500000
aliasstring | nullCase-sensitive handle, unique per team; GET /templates/{alias} resolves it
最小长度 1 · 最大长度 100 · 匹配 ^[A-Za-z0-9][A-Za-z0-9._-]*$
fromstring | nullNot supported: any value is a 422
reply_tostring | string[] | nullNot supported: any value is a 422
显示属性隐藏属性
任意项:
string
stringstring[]
string 数组stringnull
nullvariablesany[]Not supported: a non-empty list is a 422
响应
200
Template created. Every save through the API is live and publishes a new version, so status is always published. The dashboard editor keeps a working copy and publishes on request, with a version history.
objectstring必填允许值:
templateidstring<uuid>必填401
Missing, malformed, unknown or revoked API key
statusCodenumber必填namestring必填messagestring必填409
Alias already in use
statusCodenumber必填namestring必填messagestring必填422
Validation error, including from/reply_to/variables (not supported)
statusCodenumber必填namestring必填messagestring必填429
Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumber必填namestring必填messagestring必填