Templates · Versions
Save draft
Saves an email, letter, or pass design as the working copy of a template, using the organization ID and template ID. It returns savedAt. Output continues to use the published design until the draft is published.
Permissions
Send an API key of the organization in the path, using the X-API-Key header.
Who may call it
- Organization access with
template.editis required. - A receipt template also requires
receipt.edit. - A donation confirmation template also requires
donationsSettings.edit.
Request
Path parameters
-
organizationIdidrequired -
templateIdidrequired
Body
Content-Type: application/json
-
designobjectrequiredVariant 1: 5 properties
-
versionnumberrequired -
channelstringrequired -
containerobjectrequired8 properties
-
typestringrequired -
idstringrequiredpattern
^[a-zA-Z0-9_-]+$ -
desktopobjectrequired1 property
-
paddingany[]requiredexactly 4 items
-
-
mobileobjectrequired1 property
-
paddingany[]requirednullableexactly 4 items
-
-
widthintegerrequired -
fontFamilystringrequired17 values
SystemArial, Helvetica, sans-serifArial Black, Gadget, sans-serifComic Sans MS, Textile, Cursive, sans-serifCourier New, Courier, Monospace, monospaceGeorgia, Times New Roman, Times, serifHelvetica, Arial, serifImpact, Charcoal, sans-serifLucida Console, Monaco, Monospace, monospaceLucida Sans Unicode, Lucida Grande, sans-serifPalatino Linotype, Book Antiqua, Palatino, serifTahoma, Geneva, sans-serifTimes New Roman, Times, serifTrebuchet MS, Helvetica, sans-serifVerdana, Geneva, sans-serifMS Sans Serif, Geneva, sans-serifMS Serif, New York, serif -
backgroundobjectrequired3 properties
-
backgroundColorobjectrequired2 properties
-
colorstringrequiredpattern
^#[0-9A-F]{6}$ -
hidebooleanrequired
-
-
backgroundGradientobjectrequired3 properties
-
hidebooleanrequired -
stopsobject[]required2 properties
-
colorstringrequiredpattern
^#[0-9A-F]{6,8}$ -
positionnumberrequiredat least 0
-
-
angleintegerrequired
-
-
backgroundImageobjectrequired4 properties
-
hidebooleanrequired -
imageobjectrequirednullable -
sizestringrequiredcovercontainfilltile -
positionstringrequiredtop lefttop centertop rightmiddle leftmiddle centermiddle rightbottom leftbottom centerbottom right
-
-
-
itemsobject[]required14 properties
-
idstringrequiredpattern
^[a-zA-Z0-9_-]+$ -
namestringrequiredat most 32 characters
-
hideOnMobilebooleanrequired -
hideOnDesktopbooleanrequired -
hiddenbooleanrequired -
lockedbooleanrequired -
conditionobjectrequirednullable2 properties
-
operatorstringrequiredandor -
conditions(object (recursive) | object)[]requiredat least 1 items
4 properties
-
leftobject | object of anyrequiredVariant 1: 1 property
-
variablestringrequiredat least 1 characters
Variant 2: 4 properties
-
sourceobjectrequired1 property
-
variablestringrequiredat least 1 characters
-
-
lookupobjectrequirednullable1 property
-
variablestringrequiredat least 1 characters
-
-
arraybooleanrequired -
selectobject (recursive)required
Variant 3: 2 properties
-
funcstringrequired33 values
concatifEmptylowercaseuppercasesubstringtrimabsceilfloorminmaxmodsumsubmuldivavgmedparseNumberformatNumberdateOnlydateTimedateOnlyPartdateTimePartagedateOnlyDifferencedateTimeDifferencesetDateOnlysetDateTimeaddDateOnlyaddDateTimeformatDateOnlyformatDateTime -
paramsobject (recursive)[]
Variant 4: 1 property
-
literalnumber[] | numberrequired
Variant 5: 3 properties
-
ifobject (recursive)required -
thenobject (recursive)required -
elseobject (recursive)required
-
-
cmpFuncstringrequired15 values
eqisSetltltegtgteincludescontainsstartsWithendsWithbeforebeforeAtafterafterAtisToday -
rightobject | object of anyVariant 1: 1 property
-
variablestringrequiredat least 1 characters
Variant 2: 4 properties
-
sourceobjectrequired1 property
-
variablestringrequiredat least 1 characters
-
-
lookupobjectrequirednullable1 property
-
variablestringrequiredat least 1 characters
-
-
arraybooleanrequired -
selectobject (recursive)required
Variant 3: 2 properties
-
funcstringrequired33 values
concatifEmptylowercaseuppercasesubstringtrimabsceilfloorminmaxmodsumsubmuldivavgmedparseNumberformatNumberdateOnlydateTimedateOnlyPartdateTimePartagedateOnlyDifferencedateTimeDifferencesetDateOnlysetDateTimeaddDateOnlyaddDateTimeformatDateOnlyformatDateTime -
paramsobject (recursive)[]
Variant 4: 1 property
-
literalnumber[] | numberrequired
Variant 5: 3 properties
-
ifobject (recursive)required -
thenobject (recursive)required -
elseobject (recursive)required
-
-
negateboolean
-
-
-
desktopobjectrequired3 properties
-
marginany[]requiredexactly 4 items
-
paddingany[]requiredexactly 4 items
-
radiusnumber | any[]required
-
-
mobileobjectrequired3 properties
-
marginany[]requirednullableexactly 4 items
-
paddingany[]requirednullableexactly 4 items
-
radiusnumber | any[]requirednullable
-
-
typestringrequired -
repeatobjectrequirednullable1 property
-
sourceobjectrequired1 property
-
variablestringrequiredat least 1 characters
-
-
-
backgroundobjectrequired3 properties
-
backgroundColorobjectrequired2 properties
-
colorstringrequiredpattern
^#[0-9A-F]{6}$ -
hidebooleanrequired
-
-
backgroundGradientobjectrequired3 properties
-
hidebooleanrequired -
stopsobject[]required2 properties
-
colorstringrequiredpattern
^#[0-9A-F]{6,8}$ -
positionnumberrequiredat least 0
-
-
angleintegerrequired
-
-
backgroundImageobjectrequired4 properties
-
hidebooleanrequired -
imageobjectrequirednullable -
sizestringrequiredcovercontainfilltile -
positionstringrequiredtop lefttop centertop rightmiddle leftmiddle centermiddle rightbottom leftbottom centerbottom right
-
-
-
borderobjectrequired4 properties
-
colorstringrequiredpattern
^#[0-9A-F]{6}$ -
widthnumber | any[]required -
stylestringrequiredsoliddotteddashed -
hidebooleanrequired
-
-
itemsobject[]required
-
-
-
languagesstring[]requiredat least 1 items · each at least 2 characters
-
resourcesobject[]required5 properties
-
resourcestringrequiredat least 1 characters
-
fileNamestringat most 128 characters
-
contentTypestringat most 75 characters
-
fileSizeBytesintegerat least 0
-
idstringrequiredexactly 6 characters
-
Variant 2: 8 properties
-
versionnumberrequired -
channelstringrequired -
containerobjectrequired6 properties
-
typestringrequired -
idstringrequiredpattern
^[a-zA-Z0-9_-]+$ -
repeatobjectrequirednullable1 property
-
sourceobjectrequired1 property
-
variablestringrequiredat least 1 characters
-
-
-
pageSizeobjectrequired3 properties
-
widthnumberrequired -
heightnumberrequired -
landscapebooleanrequired
-
-
fontFamilystringrequired -
itemsobject[]required11 properties
-
idstringrequiredpattern
^[a-zA-Z0-9_-]+$ -
namestringrequiredat most 32 characters
-
hiddenbooleanrequired -
lockedbooleanrequired -
conditionobjectrequirednullable2 properties
-
operatorstringrequiredandor -
conditions(object (recursive) | object)[]requiredat least 1 items
4 properties
-
leftobject | object of anyrequiredVariant 1: 1 property
-
variablestringrequiredat least 1 characters
Variant 2: 4 properties
-
sourceobjectrequired1 property
-
variablestringrequiredat least 1 characters
-
-
lookupobjectrequirednullable1 property
-
variablestringrequiredat least 1 characters
-
-
arraybooleanrequired -
selectobject (recursive)required
Variant 3: 2 properties
-
funcstringrequired33 values
concatifEmptylowercaseuppercasesubstringtrimabsceilfloorminmaxmodsumsubmuldivavgmedparseNumberformatNumberdateOnlydateTimedateOnlyPartdateTimePartagedateOnlyDifferencedateTimeDifferencesetDateOnlysetDateTimeaddDateOnlyaddDateTimeformatDateOnlyformatDateTime -
paramsobject (recursive)[]
Variant 4: 1 property
-
literalnumber[] | numberrequired
Variant 5: 3 properties
-
ifobject (recursive)required -
thenobject (recursive)required -
elseobject (recursive)required
-
-
cmpFuncstringrequired15 values
eqisSetltltegtgteincludescontainsstartsWithendsWithbeforebeforeAtafterafterAtisToday -
rightobject | object of anyVariant 1: 1 property
-
variablestringrequiredat least 1 characters
Variant 2: 4 properties
-
sourceobjectrequired1 property
-
variablestringrequiredat least 1 characters
-
-
lookupobjectrequirednullable1 property
-
variablestringrequiredat least 1 characters
-
-
arraybooleanrequired -
selectobject (recursive)required
Variant 3: 2 properties
-
funcstringrequired33 values
concatifEmptylowercaseuppercasesubstringtrimabsceilfloorminmaxmodsumsubmuldivavgmedparseNumberformatNumberdateOnlydateTimedateOnlyPartdateTimePartagedateOnlyDifferencedateTimeDifferencesetDateOnlysetDateTimeaddDateOnlyaddDateTimeformatDateOnlyformatDateTime -
paramsobject (recursive)[]
Variant 4: 1 property
-
literalnumber[] | numberrequired
Variant 5: 3 properties
-
ifobject (recursive)required -
thenobject (recursive)required -
elseobject (recursive)required
-
-
negateboolean
-
-
-
typestringrequired -
repeatobjectrequirednullable1 property
-
sourceobjectrequired1 property
-
variablestringrequiredat least 1 characters
-
-
-
marginany[]requiredexactly 4 items
-
backgroundobjectrequired3 properties
-
backgroundColorobjectrequired2 properties
-
colorstringrequiredpattern
^#[0-9A-F]{6}$ -
hidebooleanrequired
-
-
backgroundGradientobjectrequired3 properties
-
hidebooleanrequired -
stopsobject[]required2 properties
-
colorstringrequiredpattern
^#[0-9A-F]{6,8}$ -
positionnumberrequiredat least 0
-
-
angleintegerrequired
-
-
backgroundImageobjectrequired4 properties
-
hidebooleanrequired -
imageobjectrequirednullable -
sizestringrequiredcovercontainfilltile -
positionstringrequiredtop lefttop centertop rightmiddle leftmiddle centermiddle rightbottom leftbottom centerbottom right
-
-
-
foldingMarksobject[]required3 properties
-
topnumberrequired -
leftnumberrequired -
widthnumberrequired
-
-
itemsobject[]required
-
-
-
unitstringrequiredpxptmmin -
languagesstring[]requiredat least 1 items · each at least 2 characters
-
onlineLetterbooleanrequired -
resourcesobject[]required5 properties
-
resourcestringrequiredat least 1 characters
-
fileNamestringat most 128 characters
-
contentTypestringat most 75 characters
-
fileSizeBytesintegerat least 0
-
idstringrequiredexactly 6 characters
-
-
attachmentobjectrequirednullable3 properties
-
resourceIdstringrequiredexactly 6 characters
-
modestringrequiredoverlayprependappend -
pagesintegerrequired
-
-
curl --fail-with-body --silent --show-error --max-time 30 --globoff \
--request POST 'https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/templates/YOUR_TEMPLATE_ID/draft' \
--header 'X-API-Key: YOUR_API_KEY'const response = await fetch("https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/templates/YOUR_TEMPLATE_ID/draft", {
method: "POST",
headers: {
"X-API-Key": "YOUR_API_KEY"
},
redirect: 'error',
signal: AbortSignal.timeout(30_000),
});
if (!response.ok) throw new Error(`campai HTTP ${response.status}`);
const text = await response.text();
const result = text ? JSON.parse(text) : null;
console.log(JSON.stringify(result, null, 2));<?php
$context = stream_context_create(['http' => [
'method' => 'POST',
'header' => [
'X-API-Key: YOUR_API_KEY',
],
'timeout' => 30,
'follow_location' => 0,
'ignore_errors' => true,
]]);
$text = @file_get_contents('https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/templates/YOUR_TEMPLATE_ID/draft', false, $context);
preg_match('/^HTTP\/\S+ (\d{3})/', $http_response_header[0] ?? '', $match);
$status = (int) ($match[1] ?? 0);
if ($text === false || $status < 200 || $status >= 300) {
throw new RuntimeException("campai HTTP $status (0 means no response)");
}
$result = $text === '' ? null : json_decode($text, true, 512, JSON_THROW_ON_ERROR);
echo json_encode($result, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
No request that worked has been recorded yet, so the body is not shown.
Response
200 Successful response
Content-Type: application/json
-
savedAtstring · date-time
{
"savedAt": "2026-06-15T22:30:00Z"
}
What else happens
- The template record is updated with the saved draft.
- New temporary assets are copied to template storage.
- Newly created resources are removed if staging fails.
- Newly staged resources are discarded if updating the template fails.
Errors
Other errors
| Status | Error | When |
|---|---|---|
| 400 | Each asset must have a unique identity. | If two assets have the same identity, the request returns HTTP 400 with composition.duplicateAsset. |
| 400 | This upload is invalid. Upload the file again. | If a new asset's resource is not a valid temporary upload ID, the request returns HTTP 400 with composition.invalidTemporaryAsset. |
| 400 | No fixed message | If the design channel is not supported by the template, the request returns HTTP 400. |
| 404 | No fixed message | If the template is not found in the organization, the request returns HTTP 404. |
| 404 | No fixed message | If copying a temporary asset fails, the request returns HTTP 404. |
Errors nearly every request can meet are listed under Errors.