v4
latestOpenAPI 3.1.02026-07-3163216290.7 KBThemes
List themes
Retrieve a paginated list of email themes, most recently created first.
get/v1/themes
Query parameters
perPagestring
How many results to return in each request. Must be between 10 and 50. Default is 20.
cursorstring
A cursor to return a specific page of results. Cursors can be found from the pagination.nextCursor value in each response.
Response
Successful.
Example response
{
"pagination": {
"totalResults": 2,
"returnedResults": 2,
"perPage": 20,
"totalPages": 1,
"nextCursor": null,
"nextPage": null
},
"data": [
{
"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"
}
]
}