countdownTimers[].idstringrequired
Example:60d5f484f0f3c2001f2d5e4a
countdownTimers[].namestringrequired
Example:Flash Sale Timer
countdownTimers[].templateIdstring
Example:minimal
countdownTimers[].locationIdstringrequired
Example:X9COWUStXtcLXTgBdqhm
countdownTimers[].statusstringrequired
Available optionsactivedraftarchived
Example:draft
countdownTimers[].timerTypestringrequired
Available optionsfixeddynamicrecurring
Example:fixed
countdownTimers[].endDatestring
Example:2026-04-01T00:00:00.000Z
countdownTimers[].startDatestring
Example:2026-03-20T00:00:00.000Z
countdownTimers[].timezonestring
Example:America/New_York
countdownTimers[].designMetaobject
Design metadata for timer appearance
countdownTimers[].designMeta.counterFontSizenumber
Example:50
countdownTimers[].designMeta.counterFontFamilystring
Example:inter
countdownTimers[].designMeta.counterFontWeightstring
Example:normal
countdownTimers[].designMeta.labelFontSizenumber
Example:15
countdownTimers[].designMeta.labelFontFamilystring
Example:inter
countdownTimers[].designMeta.labelFontWeightstring
Example:normal
countdownTimers[].designMeta.digitColorstring
Example:#a21043
countdownTimers[].designMeta.labelColorstring
Example:#a21043
countdownTimers[].designMeta.separatorColorstring
Example:#feccd6
countdownTimers[].designMeta.backgroundColorstring
Example:#ffffff
countdownTimers[].designMeta.circleBorderColorstring
Circle border color (hex)
Example:#000000
countdownTimers[].designMeta.circleFillColorstring
Example:#ffffff
countdownTimers[].designMeta.boxColorstring
Example:#101828
countdownTimers[].designMeta.borderColorstring
Example:#101828
countdownTimers[].designMeta.isTransparentboolean
Example:false
countdownTimers[].designMeta.hasSeparatorboolean
Show separator between units
Example:true
countdownTimers[].designMeta.hasFillingBorderboolean
Show filling border animation
Example:false
countdownTimers[].designMeta.hasBoxColorboolean
Show box color behind digits
Example:false
countdownTimers[].designMeta.labelsobject
countdownTimers[].designMeta.labels.daysstring
Example:Days
countdownTimers[].designMeta.labels.hoursstring
Example:Hours
countdownTimers[].designMeta.labels.minutesstring
Example:Minutes
countdownTimers[].designMeta.labels.secondsstring
Example:Seconds
countdownTimers[].designMeta.unitVisibilityobject
countdownTimers[].designMeta.unitVisibility.daysboolean
Example:true
countdownTimers[].designMeta.unitVisibility.hoursboolean
Example:true
countdownTimers[].designMeta.unitVisibility.minutesboolean
Example:true
countdownTimers[].designMeta.unitVisibility.secondsboolean
Example:true
countdownTimers[].designMeta.borderRadiusnumber
Example:12
countdownTimers[].designMeta.hasPaddingboolean
Example:true
countdownTimers[].designMeta.paddingobject
countdownTimers[].designMeta.padding.topnumber
Example:16
countdownTimers[].designMeta.padding.bottomnumber
Example:16
countdownTimers[].designMeta.padding.leftnumber
Example:16
countdownTimers[].designMeta.padding.rightnumber
Example:16
countdownTimers[].designMeta.previewUrlstring
Preview image URL from template
Example:https://storage.googleapis.com/cdn/countdown-timer/templates/minimal/preview.png
countdownTimers[].timerDurationobject
countdownTimers[].linksobject
countdownTimers[].trackingLinkstring
Example:https://t.example.com/abc123
countdownTimers[].hasLinkboolean
Whether timer has an active link
Example:true
countdownTimers[].previewUrlstring
Example:https://storage.googleapis.com/cdn/countdown-timer/preview/abc123.gif
countdownTimers[].thumbnailUrlstring
Example:https://storage.googleapis.com/cdn/countdown-timer/thumbnail/abc123.png
countdownTimers[].expiryImageLinkstring
Example:https://example.com/expiry.png
countdownTimers[].loopCountnumber
Number of recurring loops
Example:3
countdownTimers[].waitTimeobject
countdownTimers[].hideTimerForAppleMailboolean
Hide timer for Apple Mail clients
Example:false
countdownTimers[].hideRecurringTimerFunnelsboolean
Hide recurring timer in funnels
Example:false
countdownTimers[].dynamicTimerParamsobject
countdownTimers[].createdAtstring
Example:2026-03-20T12:00:00.000Z
countdownTimers[].updatedAtstring
Example:2026-03-20T12:00:00.000Z