Sign in

v4

latestOpenAPI 3.1.02026-07-3163216290.7 KB
Themes

Update a theme

Update a theme's name and/or styles. When styles change, the update cascades to every email using this theme, and affectedEmailCount in the response reports how many emails were affected. Manual style edits made on individual emails are preserved: the cascade only changes properties an email has not overridden. A per-email override is removed only when it becomes identical to the theme's new value, after which that email follows the theme for that property.

post/v1/themes/{themeId}

Request body

namestring

Response

Successful.

idstring required

The ID of the theme.

namestring required

The name of the theme.

isDefaultboolean required

Whether this theme is the team's default.

createdAtstring required

ISO 8601 timestamp for when the theme was created.

updatedAtstring required

ISO 8601 timestamp for when the theme was last updated.

affectedEmailCountnumber required

The number of emails using this theme that are affected by the style change. 0 when only the name changed.

Example response

{
  "id": "clt3u5v7w9x1y3z5a7b9c1d3",
  "name": "Default",
  "styles": {
    "backgroundColor": "#f5f5f5",
    "backgroundXPadding": 24,
    "backgroundYPadding": 24,
    "bodyColor": "#ffffff",
    "bodyXPadding": 24,
    "bodyYPadding": 24,
    "bodyFontFamily": "Helvetica",
    "bodyFontCategory": "sans-serif",
    "borderColor": "#e5e5e5",
    "borderWidth": 1,
    "borderRadius": 8,
    "buttonBodyColor": "#111827",
    "buttonBodyXPadding": 16,
    "buttonBodyYPadding": 12,
    "buttonBorderColor": "#111827",
    "buttonBorderWidth": 0,
    "buttonBorderRadius": 6,
    "buttonTextColor": "#ffffff",
    "buttonTextFormat": 0,
    "buttonTextFontSize": 16,
    "dividerColor": "#e5e5e5",
    "dividerBorderWidth": 1,
    "textBaseColor": "#374151",
    "textBaseFontSize": 16,
    "textBaseLineHeight": 24,
    "textBaseLetterSpacing": 0,
    "textLinkColor": "#2563eb",
    "heading1Color": "#111827",
    "heading1FontSize": 28,
    "heading1LineHeight": 36,
    "heading1LetterSpacing": -0.5,
    "heading2Color": "#111827",
    "heading2FontSize": 22,
    "heading2LineHeight": 30,
    "heading2LetterSpacing": -0.25,
    "heading3Color": "#111827",
    "heading3FontSize": 18,
    "heading3LineHeight": 26,
    "heading3LetterSpacing": 0
  },
  "isDefault": true,
  "createdAt": "2025-06-29T07:47:39.370Z",
  "updatedAt": "2025-06-29T07:47:39.370Z",
  "affectedEmailCount": 12
}