Skip to main content

POST /sms/templates

Save a reply

Scopesms:write
CostFree

Needs a user credential — see the note on GET /sms/templates.

Request body

FieldTypeRequiredDescription
titlestringyes
bodystringyes
{
"title": "Callback promise",
"body": "Thanks for reaching out — someone will call you back within the hour."
}

Responses

201

Saved.

FieldTypeDescription
idinteger
titlestring
bodystringThe message text.

Errors

StatusMeaning
400invalid_request — a missing or malformed field, an unknown enum value, or an unknown field in the body. Nothing was charged.
401unauthenticated — no credential, or one that is invalid, revoked or expired. The WWW-Authenticate header names the scope the endpoint wanted.
403Two different failures share this status, and the type tells them apart:
500internal_error — something failed on our side. For a send, nothing was charged, guaranteed, which is what makes a retry safe.

See Errors for the full catalog and what to do about each.

Example

curl -X POST 'https://api.account.telebroad.com/api/public/v1/sms/templates' \
-H "Authorization: Bearer $TB_KEY" \
-H 'Content-Type: application/json' \
-d '{"title":"Callback promise","body":"Thanks for reaching out — someone will call you back within the hour."}'

Try it in the playground →