Sign in
Templates

Set template localization

Creates or replaces a caller-supplied localized template variant. The locale must be enabled for the company and cannot be its primary locale.

put/templates/{templateId}/localizations/{locale}

Path parameters

templateIdstring required

Template ID, transactional email ID, or transactional slug.

localestring required

Enabled non-primary locale code such as es or pt-BR.

Request body

subjectstring required

Localized email subject line.

previewTextstring nullable

Optional localized inbox preview text.

htmlstring

Localized raw HTML. Provide exactly one of html or blocks.

Example request

{
  "blocks": [
    {
      "id": "block_123",
      "type": "html",
      "content": "<h1>Hello</h1>",
      "styles": {
        "backgroundColor": "#f8fafc",
        "backgroundOpacity": 80,
        "textColor": "#111827",
        "borderRadius": 12,
        "borderColor": "#cbd5e1",
        "borderWidth": 1
      },
      "conditions": [
        {
          "id": "c1",
          "value": "plan:pro"
        }
      ]
    }
  ]
}

Response

Template localization saved

successboolean
templateIdstring

Example response

{
  "success": true,
  "localization": {
    "locale": "es",
    "subject": "Bienvenido",
    "blocks": [
      {
        "id": "block_123",
        "type": "html",
        "content": "<h1>Hello</h1>",
        "styles": {
          "backgroundColor": "#f8fafc",
          "backgroundOpacity": 80,
          "textColor": "#111827",
          "borderRadius": 12,
          "borderColor": "#cbd5e1",
          "borderWidth": 1
        },
        "conditions": [
          {
            "id": "c1",
            "value": "plan:pro"
          }
        ]
      }
    ]
  }
}

Changes