Sign in

v4

latestOpenAPI 3.1.02026-07-3163216290.7 KB
Themes

Create a theme

Create a new email theme for use across Loops emails.

post/v1/themes

Request body

namestring required

The theme name.

Example request

{
  "name": "Dark mode",
  "styles": {
    "backgroundColor": "#111827",
    "bodyColor": "#1f2937"
  }
}

Response

Theme created.

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.

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"
}