billing
Stable
Latest stable
Trial ending v1
trial-ending - v1
Subject: Your trial is ending soon
Preheader: Upgrade to continue after your trial ends.
Required fields
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
actionButton.url |
url | Yes | Action Button URL Max 2048 characters |
https://example.com/app |
trialEndDate |
text | Yes | Trial End Date Max 1000 characters |
June 15, 2026 |
Optional fields
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
actionButton.label |
text | No | Action Button Label Max 120 characters |
Upgrade |
heading |
text | No | Heading Max 180 characters |
Your trial is ending soon |
intro |
text | No | Intro Max 1000 characters |
Your trial ends on Trial End Date. |
preheader |
text | No | Preheader Max 220 characters |
Upgrade to continue after your trial ends. |
subject |
text | No | Subject Max 180 characters |
Your trial is ending soon |
upgradeNote |
text | No | Upgrade Note Max 1000 characters |
Upgrade before your trial ends to continue. |
Defaults
{
"actionButton.label": "Upgrade",
"heading": "Your trial is ending soon",
"intro": "Your trial ends on {{trialEndDate}}.",
"preheader": "Upgrade to continue after your trial ends.",
"subject": "Your trial is ending soon",
"upgradeNote": "Upgrade before your trial ends to continue."
}
Example data
{
"templateId": "trial-ending",
"data": {
"actionButton": {
"url": "https://example.com/app"
},
"trialEndDate": "June 15, 2026"
}
}
Template messages
| Type | Code | Message |
|---|---|---|
| Return | accepted |
Valid template data can be queued by the send endpoint. |
| Error | missing_required_variable |
Action Button URL is required. |
| Error | missing_required_variable |
Trial End Date is required. |
| Error | field_too_long |
Action Button URL must be 2048 characters or fewer. |
| Error | invalid_url |
Action Button URL must be a valid http or https URL. |
| Error | field_too_long |
Trial End Date must be 1000 characters or fewer. |
| Error | field_too_long |
Action Button Label must be 120 characters or fewer. |
| Error | field_too_long |
Heading must be 180 characters or fewer. |
| Error | field_too_long |
Intro must be 1000 characters or fewer. |
| Error | field_too_long |
Preheader must be 220 characters or fewer. |
| Error | field_too_long |
Subject must be 180 characters or fewer. |
| Error | field_too_long |
Upgrade Note must be 1000 characters or fewer. |