Save a reply an inbox can send

PUT
/v1/email/mailboxes/{address}/templates

Saves a reply on an inbox, or replaces the one with the same name. Put {{placeholders}} where the words change; you give their values when you send. You can change them whether or not the inbox sends only from saved replies, with a key for the workspace or in the dashboard; a key limited to this one inbox cannot, because it would be writing itself a way around its own setting.

Requires an API key with the mailbox:manage scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Path Parameters

address*string

The inbox address.

Request Body

application/json
  1. body
name*string

What you call it: letters, numbers, spaces, dots, dashes and underscores.

Match^[A-Za-z0-9][A-Za-z0-9 ._-]*$
Length1 <= length <= 64
subject?string

One line. Optional.

Length1 <= length <= 200
body*string

The words of the reply, with {{placeholders}} where they change.

Length1 <= length <= 10000

Response Body

Saved; a reply with the same name was replaced

application/json
  1. response
template*
replaced*boolean
summary*string
Example Request
curl -X PUT "https://api.vlayers.ai/v1/email/mailboxes/$MAILBOX_ADDRESS/templates" \  -H "Authorization: Bearer $VOICELAYER_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "name": "Refund approved",    "subject": "Your refund",    "body": "Hi {{name}}, your refund is on its way."  }'
Example Response
{  "template": {    "name": "Refund approved",    "subject": "Your refund",    "body": "Hi {{name}}, your refund is on its way.",    "variables": [      "name"    ],    "updatedAt": "2026-10-20T15:04:05.000Z"  },  "replaced": false,  "summary": "Saved the reply \"Refund approved\" on [email protected]."}