Skip to navigation

Edit a Template

PUT https://api.beconversive.com/api/v2/templates/{template_id}

Updates a template. Send only the fields you want to change; fields you do not send are left unchanged. A template’s channel cannot be changed.

curl -X PUT https://api.beconversive.com/api/v2/templates/102031 \
-H "apiKey: <API_KEY>" \
-H "Content-Type: application/json" \
-d '{"text": "Hi, welcome back!"}'

200 Updated

{
"message": "SMS template has been updated successfully"
}

Authentication

NameTypeRequiredDescription
apiKeystringRequiredAPI key authentication via header.

Path parameters

NameTypeRequiredDescription
template_idintegerRequiredID of the template to update.

Request body

Any body parameter from Create a template, except channel. When changing integration, record_type can be omitted if the template already has one.

Response

NameTypeDescription
messagestringConfirmation message.

Errors

StatusErrorDescription
400 Bad RequestMISSING-RECORD-TYPEintegration was sent without record_type, and the template has none.
400 Bad RequestBAD-TEMPLATE-NAMEThe name contains characters that are not allowed.
401 UnauthorizedNO-API-KEY / FORBIDDEN-API-KEYThe API key is missing or not valid.
403 Forbidden—More than 25 requests in a minute. Wait a minute and retry.
404 Not FoundTEMPLATE-NOT-FOUNDNo template with this ID exists in the account.