[{"data":1,"prerenderedAt":1565},["ShallowReactive",2],{"docs-navigation":3,"\u002Fdocs\u002Fapi\u002Ftemplates":202,"\u002Fdocs\u002Fapi\u002Ftemplates-surround":1560},[4],{"title":5,"path":6,"stem":7,"children":8,"page":22},"Docs","\u002Fdocs","docs",[9,23,36,65,86,115,128,172,185],{"title":10,"path":11,"stem":12,"children":13,"page":22},"Getting started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started",[14,18],{"title":15,"path":16,"stem":17},"Quickstart","\u002Fdocs\u002Fgetting-started\u002Fquickstart","docs\u002F1.getting-started\u002F1.quickstart",{"title":19,"path":20,"stem":21},"Concepts","\u002Fdocs\u002Fgetting-started\u002Fconcepts","docs\u002F1.getting-started\u002F2.concepts",false,{"title":24,"path":25,"stem":26,"children":27,"page":22},"Sending domain","\u002Fdocs\u002Fdomains","docs\u002F2.domains",[28,32],{"title":29,"path":30,"stem":31},"Add your domain","\u002Fdocs\u002Fdomains\u002Fadd-your-domain","docs\u002F2.domains\u002F1.add-your-domain",{"title":33,"path":34,"stem":35},"Troubleshooting","\u002Fdocs\u002Fdomains\u002Ftroubleshooting","docs\u002F2.domains\u002F2.troubleshooting",{"title":37,"path":38,"stem":39,"children":40,"page":22},"Audience","\u002Fdocs\u002Faudience","docs\u002F3.audience",[41,45,49,53,57,61],{"title":42,"path":43,"stem":44},"Contacts","\u002Fdocs\u002Faudience\u002Fcontacts","docs\u002F3.audience\u002F1.contacts",{"title":46,"path":47,"stem":48},"Import contacts","\u002Fdocs\u002Faudience\u002Fimport","docs\u002F3.audience\u002F2.import",{"title":50,"path":51,"stem":52},"Lists","\u002Fdocs\u002Faudience\u002Flists","docs\u002F3.audience\u002F3.lists",{"title":54,"path":55,"stem":56},"Segments","\u002Fdocs\u002Faudience\u002Fsegments","docs\u002F3.audience\u002F4.segments",{"title":58,"path":59,"stem":60},"Signup forms","\u002Fdocs\u002Faudience\u002Fsignup-forms","docs\u002F3.audience\u002F5.signup-forms",{"title":62,"path":63,"stem":64},"Unsubscribe and preferences","\u002Fdocs\u002Faudience\u002Funsubscribe-and-preferences","docs\u002F3.audience\u002F6.unsubscribe-and-preferences",{"title":66,"path":67,"stem":68,"children":69,"page":22},"Sending emails","\u002Fdocs\u002Femails","docs\u002F4.emails",[70,74,78,82],{"title":71,"path":72,"stem":73},"Writing emails","\u002Fdocs\u002Femails\u002Fwriting-emails","docs\u002F4.emails\u002F1.writing-emails",{"title":75,"path":76,"stem":77},"Campaigns","\u002Fdocs\u002Femails\u002Fcampaigns","docs\u002F4.emails\u002F2.campaigns",{"title":79,"path":80,"stem":81},"Flows","\u002Fdocs\u002Femails\u002Fflows","docs\u002F4.emails\u002F3.flows",{"title":83,"path":84,"stem":85},"Transactional emails","\u002Fdocs\u002Femails\u002Ftransactional","docs\u002F4.emails\u002F4.transactional",{"title":87,"path":88,"stem":89,"children":90,"page":22},"Deliverability","\u002Fdocs\u002Fdeliverability","docs\u002F5.deliverability",[91,95,99,103,107,111],{"title":92,"path":93,"stem":94},"Overview","\u002Fdocs\u002Fdeliverability\u002Foverview","docs\u002F5.deliverability\u002F1.overview",{"title":96,"path":97,"stem":98},"Warm-up","\u002Fdocs\u002Fdeliverability\u002Fwarm-up","docs\u002F5.deliverability\u002F2.warm-up",{"title":100,"path":101,"stem":102},"Contacts under review","\u002Fdocs\u002Fdeliverability\u002Fimported-contacts","docs\u002F5.deliverability\u002F3.imported-contacts",{"title":104,"path":105,"stem":106},"Reputation","\u002Fdocs\u002Fdeliverability\u002Freputation","docs\u002F5.deliverability\u002F4.reputation",{"title":108,"path":109,"stem":110},"Bounces and suppressions","\u002Fdocs\u002Fdeliverability\u002Fbounces-and-suppressions","docs\u002F5.deliverability\u002F5.bounces-and-suppressions",{"title":112,"path":113,"stem":114},"Deliverability report","\u002Fdocs\u002Fdeliverability\u002Fdeliverability-report","docs\u002F5.deliverability\u002F6.deliverability-report",{"title":116,"path":117,"stem":118,"children":119,"page":22},"AI","\u002Fdocs\u002Fai","docs\u002F6.ai",[120,124],{"title":121,"path":122,"stem":123},"Assistant","\u002Fdocs\u002Fai\u002Fassistant","docs\u002F6.ai\u002F1.assistant",{"title":125,"path":126,"stem":127},"Connect your agent (MCP)","\u002Fdocs\u002Fai\u002Fmcp","docs\u002F6.ai\u002F2.mcp",{"title":129,"path":130,"stem":131,"children":132,"page":22},"API reference","\u002Fdocs\u002Fapi","docs\u002F7.api",[133,137,141,145,148,152,156,160,164,168],{"title":134,"path":135,"stem":136},"Introduction","\u002Fdocs\u002Fapi\u002Fintroduction","docs\u002F7.api\u002F01.introduction",{"title":138,"path":139,"stem":140},"Emails","\u002Fdocs\u002Fapi\u002Femails","docs\u002F7.api\u002F02.emails",{"title":142,"path":143,"stem":144},"Templates","\u002Fdocs\u002Fapi\u002Ftemplates","docs\u002F7.api\u002F03.templates",{"title":42,"path":146,"stem":147},"\u002Fdocs\u002Fapi\u002Fcontacts","docs\u002F7.api\u002F04.contacts",{"title":149,"path":150,"stem":151},"Events","\u002Fdocs\u002Fapi\u002Fevents","docs\u002F7.api\u002F05.events",{"title":153,"path":154,"stem":155},"Lists and segments","\u002Fdocs\u002Fapi\u002Flists-and-segments","docs\u002F7.api\u002F06.lists-and-segments",{"title":157,"path":158,"stem":159},"Campaigns and flows","\u002Fdocs\u002Fapi\u002Fcampaigns-and-flows","docs\u002F7.api\u002F07.campaigns-and-flows",{"title":161,"path":162,"stem":163},"Domains and suppressions","\u002Fdocs\u002Fapi\u002Fdomains-and-suppressions","docs\u002F7.api\u002F08.domains-and-suppressions",{"title":165,"path":166,"stem":167},"Spaces","\u002Fdocs\u002Fapi\u002Fspaces","docs\u002F7.api\u002F09.spaces",{"title":169,"path":170,"stem":171},"Webhooks","\u002Fdocs\u002Fapi\u002Fwebhooks","docs\u002F7.api\u002F10.webhooks",{"title":173,"path":174,"stem":175,"children":176,"page":22},"Account & billing","\u002Fdocs\u002Faccount","docs\u002F8.account",[177,181],{"title":178,"path":179,"stem":180},"Spaces and members","\u002Fdocs\u002Faccount\u002Fspaces-and-members","docs\u002F8.account\u002F1.spaces-and-members",{"title":182,"path":183,"stem":184},"Billing","\u002Fdocs\u002Faccount\u002Fbilling","docs\u002F8.account\u002F2.billing",{"title":186,"path":187,"stem":188,"children":189,"page":22},"Guides","\u002Fdocs\u002Fguides","docs\u002F9.guides",[190,194,198],{"title":191,"path":192,"stem":193},"Welcome new subscribers","\u002Fdocs\u002Fguides\u002Fwelcome-sequence","docs\u002F9.guides\u002F1.welcome-sequence",{"title":195,"path":196,"stem":197},"Onboarding with events","\u002Fdocs\u002Fguides\u002Fonboarding-with-events","docs\u002F9.guides\u002F2.onboarding-with-events",{"title":199,"path":200,"stem":201},"Migrate from another tool","\u002Fdocs\u002Fguides\u002Fmigrate-from-another-tool","docs\u002F9.guides\u002F3.migrate-from-another-tool",{"id":203,"title":142,"body":204,"description":1553,"extension":1554,"links":1555,"meta":1556,"navigation":1557,"path":143,"seo":1558,"stem":144,"__hash__":1559},"docs\u002Fdocs\u002F7.api\u002F03.templates.md",{"type":205,"value":206,"toc":1542},"minimark",[207,223,228,231,256,267,323,333,337,974,1003,1020,1024,1029,1032,1062,1069,1073,1078,1081,1148,1229,1243,1292,1296,1301,1307,1331,1335,1340,1350,1362,1416,1425,1429,1434,1437,1466,1505,1509,1514,1520,1524,1529,1538],[208,209,210,211,218,219,222],"p",{},"Manage the templates sent with ",[212,213,214],"a",{"href":139},[215,216,217],"code",{},"POST \u002Fv1\u002Femails"," from code or a deploy script. ",[212,220,221],{"href":84},"Transactional emails explained",".",[224,225,227],"h2",{"id":226},"draft-and-published-version","Draft and published version",[208,229,230],{},"Every template has two versions:",[232,233,234,247],"ul",{},[235,236,237,238,242,243,246],"li",{},"the ",[239,240,241],"strong",{},"draft",", which you edit (dashboard, ",[215,244,245],{},"PATCH",", AI assistant);",[235,248,237,249,252,253,255],{},[239,250,251],{},"published version",", the only one ",[215,254,217],{}," sends.",[208,257,258,259,262,263,266],{},"Edits reach your users only once you ",[239,260,261],{},"publish",". A template never published cannot be sent (",[215,264,265],{},"409 template_not_published",").",[268,269,270,285],"table",{},[271,272,273],"thead",{},[274,275,276,282],"tr",{},[277,278,279],"th",{},[215,280,281],{},"status",[277,283,284],{},"Meaning",[286,287,288,299,309],"tbody",{},[274,289,290,296],{},[291,292,293],"td",{},[215,294,295],{},"NEVER_PUBLISHED",[291,297,298],{},"Draft only, not sendable yet",[274,300,301,306],{},[291,302,303],{},[215,304,305],{},"PUBLISHED",[291,307,308],{},"The draft is what gets sent",[274,310,311,316],{},[291,312,313],{},[215,314,315],{},"UNPUBLISHED_CHANGES",[291,317,318,319,322],{},"The draft differs from the published version; ",[215,320,321],{},"changedFields"," lists what changed",[208,324,325,328,329,332],{},[215,326,327],{},"name"," and ",[215,330,331],{},"alias"," are not versioned: they change as soon as you save.",[224,334,336],{"id":335},"the-template-object","The template object",[338,339,344],"pre",{"className":340,"code":341,"language":342,"meta":343,"style":343},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"id\": \"c41d7e2a-9b8f-4a6e-b3d2-5f1e0a9c8b7d\",\n  \"name\": \"Password reset\",\n  \"alias\": \"password-reset\",\n  \"subject\": \"Reset your password\",\n  \"preheader\": \"This link expires in {{ data.expires_in }}\",\n  \"fromName\": \"Acme\",\n  \"fromEmail\": \"security@acme.com\",\n  \"replyTo\": null,\n  \"contentFormat\": \"MARKDOWN\",\n  \"content\": \"Hi {{ contact.first_name | default: \\\"there\\\" }},\\n\\n[Choose a new password]({{ data.reset_url }})\",\n  \"status\": \"PUBLISHED\",\n  \"changedFields\": [],\n  \"published\": {\n    \"subject\": \"Reset your password\",\n    \"preheader\": \"This link expires in {{ data.expires_in }}\",\n    \"fromName\": \"Acme\",\n    \"fromEmail\": \"security@acme.com\",\n    \"replyTo\": null,\n    \"contentFormat\": \"MARKDOWN\",\n    \"content\": \"Hi {{ contact.first_name | default: \\\"there\\\" }},\\n\\n[Choose a new password]({{ data.reset_url }})\"\n  },\n  \"publishedAt\": \"2026-10-12T14:03:11Z\",\n  \"publishedBy\": \"Ada Lovelace\",\n  \"publicationRequest\": null,\n  \"createdVia\": \"DASHBOARD\",\n  \"createdAt\": \"2026-10-12T13:40:52Z\",\n  \"updatedAt\": \"2026-10-12T14:03:11Z\",\n  \"stats\": { \"sent\": 1834, \"delivered\": 1829, \"opened\": 1402, \"bounced\": 5 }\n}\n","json","",[215,345,346,355,383,403,423,444,465,486,507,522,543,582,601,615,630,651,670,689,708,721,740,770,776,797,818,832,853,874,894,968],{"__ignoreMap":343},[347,348,351],"span",{"class":349,"line":350},"line",1,[347,352,354],{"class":353},"sMK4o","{\n",[347,356,358,361,365,368,371,374,378,380],{"class":349,"line":357},2,[347,359,360],{"class":353},"  \"",[347,362,364],{"class":363},"spNyl","id",[347,366,367],{"class":353},"\"",[347,369,370],{"class":353},":",[347,372,373],{"class":353}," \"",[347,375,377],{"class":376},"sfazB","c41d7e2a-9b8f-4a6e-b3d2-5f1e0a9c8b7d",[347,379,367],{"class":353},[347,381,382],{"class":353},",\n",[347,384,386,388,390,392,394,396,399,401],{"class":349,"line":385},3,[347,387,360],{"class":353},[347,389,327],{"class":363},[347,391,367],{"class":353},[347,393,370],{"class":353},[347,395,373],{"class":353},[347,397,398],{"class":376},"Password reset",[347,400,367],{"class":353},[347,402,382],{"class":353},[347,404,406,408,410,412,414,416,419,421],{"class":349,"line":405},4,[347,407,360],{"class":353},[347,409,331],{"class":363},[347,411,367],{"class":353},[347,413,370],{"class":353},[347,415,373],{"class":353},[347,417,418],{"class":376},"password-reset",[347,420,367],{"class":353},[347,422,382],{"class":353},[347,424,426,428,431,433,435,437,440,442],{"class":349,"line":425},5,[347,427,360],{"class":353},[347,429,430],{"class":363},"subject",[347,432,367],{"class":353},[347,434,370],{"class":353},[347,436,373],{"class":353},[347,438,439],{"class":376},"Reset your password",[347,441,367],{"class":353},[347,443,382],{"class":353},[347,445,447,449,452,454,456,458,461,463],{"class":349,"line":446},6,[347,448,360],{"class":353},[347,450,451],{"class":363},"preheader",[347,453,367],{"class":353},[347,455,370],{"class":353},[347,457,373],{"class":353},[347,459,460],{"class":376},"This link expires in {{ data.expires_in }}",[347,462,367],{"class":353},[347,464,382],{"class":353},[347,466,468,470,473,475,477,479,482,484],{"class":349,"line":467},7,[347,469,360],{"class":353},[347,471,472],{"class":363},"fromName",[347,474,367],{"class":353},[347,476,370],{"class":353},[347,478,373],{"class":353},[347,480,481],{"class":376},"Acme",[347,483,367],{"class":353},[347,485,382],{"class":353},[347,487,489,491,494,496,498,500,503,505],{"class":349,"line":488},8,[347,490,360],{"class":353},[347,492,493],{"class":363},"fromEmail",[347,495,367],{"class":353},[347,497,370],{"class":353},[347,499,373],{"class":353},[347,501,502],{"class":376},"security@acme.com",[347,504,367],{"class":353},[347,506,382],{"class":353},[347,508,510,512,515,517,519],{"class":349,"line":509},9,[347,511,360],{"class":353},[347,513,514],{"class":363},"replyTo",[347,516,367],{"class":353},[347,518,370],{"class":353},[347,520,521],{"class":353}," null,\n",[347,523,525,527,530,532,534,536,539,541],{"class":349,"line":524},10,[347,526,360],{"class":353},[347,528,529],{"class":363},"contentFormat",[347,531,367],{"class":353},[347,533,370],{"class":353},[347,535,373],{"class":353},[347,537,538],{"class":376},"MARKDOWN",[347,540,367],{"class":353},[347,542,382],{"class":353},[347,544,546,548,551,553,555,557,560,564,567,569,572,575,578,580],{"class":349,"line":545},11,[347,547,360],{"class":353},[347,549,550],{"class":363},"content",[347,552,367],{"class":353},[347,554,370],{"class":353},[347,556,373],{"class":353},[347,558,559],{"class":376},"Hi {{ contact.first_name | default: ",[347,561,563],{"class":562},"sTEyZ","\\\"",[347,565,566],{"class":376},"there",[347,568,563],{"class":562},[347,570,571],{"class":376}," }},",[347,573,574],{"class":562},"\\n\\n",[347,576,577],{"class":376},"[Choose a new password]({{ data.reset_url }})",[347,579,367],{"class":353},[347,581,382],{"class":353},[347,583,585,587,589,591,593,595,597,599],{"class":349,"line":584},12,[347,586,360],{"class":353},[347,588,281],{"class":363},[347,590,367],{"class":353},[347,592,370],{"class":353},[347,594,373],{"class":353},[347,596,305],{"class":376},[347,598,367],{"class":353},[347,600,382],{"class":353},[347,602,604,606,608,610,612],{"class":349,"line":603},13,[347,605,360],{"class":353},[347,607,321],{"class":363},[347,609,367],{"class":353},[347,611,370],{"class":353},[347,613,614],{"class":353}," [],\n",[347,616,618,620,623,625,627],{"class":349,"line":617},14,[347,619,360],{"class":353},[347,621,622],{"class":363},"published",[347,624,367],{"class":353},[347,626,370],{"class":353},[347,628,629],{"class":353}," {\n",[347,631,633,636,639,641,643,645,647,649],{"class":349,"line":632},15,[347,634,635],{"class":353},"    \"",[347,637,430],{"class":638},"sBMFI",[347,640,367],{"class":353},[347,642,370],{"class":353},[347,644,373],{"class":353},[347,646,439],{"class":376},[347,648,367],{"class":353},[347,650,382],{"class":353},[347,652,654,656,658,660,662,664,666,668],{"class":349,"line":653},16,[347,655,635],{"class":353},[347,657,451],{"class":638},[347,659,367],{"class":353},[347,661,370],{"class":353},[347,663,373],{"class":353},[347,665,460],{"class":376},[347,667,367],{"class":353},[347,669,382],{"class":353},[347,671,673,675,677,679,681,683,685,687],{"class":349,"line":672},17,[347,674,635],{"class":353},[347,676,472],{"class":638},[347,678,367],{"class":353},[347,680,370],{"class":353},[347,682,373],{"class":353},[347,684,481],{"class":376},[347,686,367],{"class":353},[347,688,382],{"class":353},[347,690,692,694,696,698,700,702,704,706],{"class":349,"line":691},18,[347,693,635],{"class":353},[347,695,493],{"class":638},[347,697,367],{"class":353},[347,699,370],{"class":353},[347,701,373],{"class":353},[347,703,502],{"class":376},[347,705,367],{"class":353},[347,707,382],{"class":353},[347,709,711,713,715,717,719],{"class":349,"line":710},19,[347,712,635],{"class":353},[347,714,514],{"class":638},[347,716,367],{"class":353},[347,718,370],{"class":353},[347,720,521],{"class":353},[347,722,724,726,728,730,732,734,736,738],{"class":349,"line":723},20,[347,725,635],{"class":353},[347,727,529],{"class":638},[347,729,367],{"class":353},[347,731,370],{"class":353},[347,733,373],{"class":353},[347,735,538],{"class":376},[347,737,367],{"class":353},[347,739,382],{"class":353},[347,741,743,745,747,749,751,753,755,757,759,761,763,765,767],{"class":349,"line":742},21,[347,744,635],{"class":353},[347,746,550],{"class":638},[347,748,367],{"class":353},[347,750,370],{"class":353},[347,752,373],{"class":353},[347,754,559],{"class":376},[347,756,563],{"class":562},[347,758,566],{"class":376},[347,760,563],{"class":562},[347,762,571],{"class":376},[347,764,574],{"class":562},[347,766,577],{"class":376},[347,768,769],{"class":353},"\"\n",[347,771,773],{"class":349,"line":772},22,[347,774,775],{"class":353},"  },\n",[347,777,779,781,784,786,788,790,793,795],{"class":349,"line":778},23,[347,780,360],{"class":353},[347,782,783],{"class":363},"publishedAt",[347,785,367],{"class":353},[347,787,370],{"class":353},[347,789,373],{"class":353},[347,791,792],{"class":376},"2026-10-12T14:03:11Z",[347,794,367],{"class":353},[347,796,382],{"class":353},[347,798,800,802,805,807,809,811,814,816],{"class":349,"line":799},24,[347,801,360],{"class":353},[347,803,804],{"class":363},"publishedBy",[347,806,367],{"class":353},[347,808,370],{"class":353},[347,810,373],{"class":353},[347,812,813],{"class":376},"Ada Lovelace",[347,815,367],{"class":353},[347,817,382],{"class":353},[347,819,821,823,826,828,830],{"class":349,"line":820},25,[347,822,360],{"class":353},[347,824,825],{"class":363},"publicationRequest",[347,827,367],{"class":353},[347,829,370],{"class":353},[347,831,521],{"class":353},[347,833,835,837,840,842,844,846,849,851],{"class":349,"line":834},26,[347,836,360],{"class":353},[347,838,839],{"class":363},"createdVia",[347,841,367],{"class":353},[347,843,370],{"class":353},[347,845,373],{"class":353},[347,847,848],{"class":376},"DASHBOARD",[347,850,367],{"class":353},[347,852,382],{"class":353},[347,854,856,858,861,863,865,867,870,872],{"class":349,"line":855},27,[347,857,360],{"class":353},[347,859,860],{"class":363},"createdAt",[347,862,367],{"class":353},[347,864,370],{"class":353},[347,866,373],{"class":353},[347,868,869],{"class":376},"2026-10-12T13:40:52Z",[347,871,367],{"class":353},[347,873,382],{"class":353},[347,875,877,879,882,884,886,888,890,892],{"class":349,"line":876},28,[347,878,360],{"class":353},[347,880,881],{"class":363},"updatedAt",[347,883,367],{"class":353},[347,885,370],{"class":353},[347,887,373],{"class":353},[347,889,792],{"class":376},[347,891,367],{"class":353},[347,893,382],{"class":353},[347,895,897,899,902,904,906,909,911,914,916,918,922,925,927,930,932,934,937,939,941,944,946,948,951,953,955,958,960,962,965],{"class":349,"line":896},29,[347,898,360],{"class":353},[347,900,901],{"class":363},"stats",[347,903,367],{"class":353},[347,905,370],{"class":353},[347,907,908],{"class":353}," {",[347,910,373],{"class":353},[347,912,913],{"class":638},"sent",[347,915,367],{"class":353},[347,917,370],{"class":353},[347,919,921],{"class":920},"sbssI"," 1834",[347,923,924],{"class":353},",",[347,926,373],{"class":353},[347,928,929],{"class":638},"delivered",[347,931,367],{"class":353},[347,933,370],{"class":353},[347,935,936],{"class":920}," 1829",[347,938,924],{"class":353},[347,940,373],{"class":353},[347,942,943],{"class":638},"opened",[347,945,367],{"class":353},[347,947,370],{"class":353},[347,949,950],{"class":920}," 1402",[347,952,924],{"class":353},[347,954,373],{"class":353},[347,956,957],{"class":638},"bounced",[347,959,367],{"class":353},[347,961,370],{"class":353},[347,963,964],{"class":920}," 5",[347,966,967],{"class":353}," }\n",[347,969,971],{"class":349,"line":970},30,[347,972,973],{"class":353},"}\n",[208,975,976,977,979,980,982,983,985,986,988,989,992,993,995,996,998,999,1002],{},"The top-level ",[215,978,430],{}," to ",[215,981,550],{}," fields are the ",[239,984,241],{},"; ",[215,987,622],{}," is the version sent, ",[215,990,991],{},"null"," until the first publication. ",[215,994,901],{}," covers the last 30 days. ",[215,997,825],{}," is set when an ",[212,1000,1001],{"href":126},"AI assistant"," asked a person to publish the draft.",[208,1004,1005,1008,1009,1012,1013,1016,1017,222],{},[215,1006,1007],{},"{{ data.* }}"," reads the ",[215,1010,1011],{},"variables"," of the send; ",[215,1014,1015],{},"{{ contact.* }}"," reads the recipient's contact, if any. ",[212,1018,1019],{"href":72},"Variables reference",[224,1021,1023],{"id":1022},"list-templates","List templates",[208,1025,1026],{},[215,1027,1028],{},"GET \u002Fv1\u002Ftemplates",[208,1030,1031],{},"Every template of the space, newest first, with its 30-day stats.",[338,1033,1037],{"className":1034,"code":1035,"language":1036,"meta":343,"style":343},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl https:\u002F\u002Fapi.kulamail.com\u002Fv1\u002Ftemplates \\\n  -H \"Authorization: Bearer ml_your_api_key\"\n","bash",[215,1038,1039,1050],{"__ignoreMap":343},[347,1040,1041,1044,1047],{"class":349,"line":350},[347,1042,1043],{"class":638},"curl",[347,1045,1046],{"class":376}," https:\u002F\u002Fapi.kulamail.com\u002Fv1\u002Ftemplates",[347,1048,1049],{"class":562}," \\\n",[347,1051,1052,1055,1057,1060],{"class":349,"line":357},[347,1053,1054],{"class":376},"  -H",[347,1056,373],{"class":353},[347,1058,1059],{"class":376},"Authorization: Bearer ml_your_api_key",[347,1061,769],{"class":353},[208,1063,1064,1065,222],{},"Returns an array of ",[212,1066,1068],{"href":1067},"#the-template-object","template objects",[224,1070,1072],{"id":1071},"create-a-template","Create a template",[208,1074,1075],{},[215,1076,1077],{},"POST \u002Fv1\u002Ftemplates",[208,1079,1080],{},"Creates a template as a draft. Publish it before sending.",[1082,1083,1084,1092,1107,1112,1117,1122,1127,1132,1143],"field-group",{},[1085,1086,1089],"field",{"name":327,"type":1087,":required":1088},"string","true",[208,1090,1091],{},"Shown in the dashboard. 120 characters at most.",[1085,1093,1094],{"name":331,"type":1087,":required":1088},[208,1095,1096,1097,1099,1100,328,1103,1106],{},"The stable key your code sends with, such as ",[215,1098,418],{},". Lowercase letters, digits, ",[215,1101,1102],{},"-",[215,1104,1105],{},"_",", 100 characters at most, unique in the space.",[1085,1108,1109],{"name":430,"type":1087,":required":1088},[208,1110,1111],{},"500 characters at most. Variables allowed.",[1085,1113,1114],{"name":451,"type":1087},[208,1115,1116],{},"Inbox preview text after the subject. 500 characters at most.",[1085,1118,1119],{"name":472,"type":1087},[208,1120,1121],{},"Sender name. Defaults to the space's.",[1085,1123,1124],{"name":493,"type":1087},[208,1125,1126],{},"Sender address on a verified domain of the space. Defaults to the space's.",[1085,1128,1129],{"name":514,"type":1087},[208,1130,1131],{},"Reply-to address.",[1085,1133,1134],{"name":529,"type":1087},[208,1135,1136,1138,1139,1142],{},[215,1137,538],{}," (wrapped in the space design) or ",[215,1140,1141],{},"HTML"," (sent as given).",[1085,1144,1145],{"name":550,"type":1087},[208,1146,1147],{},"The body, 1,000,000 characters at most.",[338,1149,1151],{"className":1034,"code":1150,"language":1036,"meta":343,"style":343},"curl https:\u002F\u002Fapi.kulamail.com\u002Fv1\u002Ftemplates \\\n  -H \"Authorization: Bearer ml_your_api_key\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"name\": \"Password reset\",\n    \"alias\": \"password-reset\",\n    \"subject\": \"Reset your password\",\n    \"contentFormat\": \"MARKDOWN\",\n    \"content\": \"Hi {{ contact.first_name | default: \\\"there\\\" }},\\n\\n[Choose a new password]({{ data.reset_url }})\\n\\nThis link expires in {{ data.expires_in }}.\"\n  }'\n",[215,1152,1153,1161,1173,1186,1196,1201,1206,1211,1216,1221],{"__ignoreMap":343},[347,1154,1155,1157,1159],{"class":349,"line":350},[347,1156,1043],{"class":638},[347,1158,1046],{"class":376},[347,1160,1049],{"class":562},[347,1162,1163,1165,1167,1169,1171],{"class":349,"line":357},[347,1164,1054],{"class":376},[347,1166,373],{"class":353},[347,1168,1059],{"class":376},[347,1170,367],{"class":353},[347,1172,1049],{"class":562},[347,1174,1175,1177,1179,1182,1184],{"class":349,"line":385},[347,1176,1054],{"class":376},[347,1178,373],{"class":353},[347,1180,1181],{"class":376},"Content-Type: application\u002Fjson",[347,1183,367],{"class":353},[347,1185,1049],{"class":562},[347,1187,1188,1191,1194],{"class":349,"line":405},[347,1189,1190],{"class":376},"  -d",[347,1192,1193],{"class":353}," '",[347,1195,354],{"class":376},[347,1197,1198],{"class":349,"line":425},[347,1199,1200],{"class":376},"    \"name\": \"Password reset\",\n",[347,1202,1203],{"class":349,"line":446},[347,1204,1205],{"class":376},"    \"alias\": \"password-reset\",\n",[347,1207,1208],{"class":349,"line":467},[347,1209,1210],{"class":376},"    \"subject\": \"Reset your password\",\n",[347,1212,1213],{"class":349,"line":488},[347,1214,1215],{"class":376},"    \"contentFormat\": \"MARKDOWN\",\n",[347,1217,1218],{"class":349,"line":509},[347,1219,1220],{"class":376},"    \"content\": \"Hi {{ contact.first_name | default: \\\"there\\\" }},\\n\\n[Choose a new password]({{ data.reset_url }})\\n\\nThis link expires in {{ data.expires_in }}.\"\n",[347,1222,1223,1226],{"class":349,"line":524},[347,1224,1225],{"class":376},"  }",[347,1227,1228],{"class":353},"'\n",[208,1230,1231,1232,1235,1236,1239,1240,222],{},"Returns ",[215,1233,1234],{},"201"," with the ",[212,1237,1238],{"href":1067},"template object",", ",[215,1241,1242],{},"status: \"NEVER_PUBLISHED\"",[268,1244,1245,1258],{},[271,1246,1247],{},[274,1248,1249,1252,1255],{},[277,1250,1251],{},"Status",[277,1253,1254],{},"Code",[277,1256,1257],{},"When",[286,1259,1260,1279],{},[274,1261,1262,1265,1276],{},[291,1263,1264],{},"400",[291,1266,1267,1239,1270,1239,1273],{},[215,1268,1269],{},"validation_error",[215,1271,1272],{},"bad_request",[215,1274,1275],{},"domain_not_verified",[291,1277,1278],{},"Missing field, invalid alias, or sender not on a verified domain",[274,1280,1281,1284,1289],{},[291,1282,1283],{},"409",[291,1285,1286],{},[215,1287,1288],{},"alias_taken",[291,1290,1291],{},"The alias is already used in the space",[224,1293,1295],{"id":1294},"get-a-template","Get a template",[208,1297,1298],{},[215,1299,1300],{},"GET \u002Fv1\u002Ftemplates\u002F{template}",[208,1302,1303,1306],{},[215,1304,1305],{},"{template}"," is the id or the alias.",[338,1308,1310],{"className":1034,"code":1309,"language":1036,"meta":343,"style":343},"curl https:\u002F\u002Fapi.kulamail.com\u002Fv1\u002Ftemplates\u002Fpassword-reset \\\n  -H \"Authorization: Bearer ml_your_api_key\"\n",[215,1311,1312,1321],{"__ignoreMap":343},[347,1313,1314,1316,1319],{"class":349,"line":350},[347,1315,1043],{"class":638},[347,1317,1318],{"class":376}," https:\u002F\u002Fapi.kulamail.com\u002Fv1\u002Ftemplates\u002Fpassword-reset",[347,1320,1049],{"class":562},[347,1322,1323,1325,1327,1329],{"class":349,"line":357},[347,1324,1054],{"class":376},[347,1326,373],{"class":353},[347,1328,1059],{"class":376},[347,1330,769],{"class":353},[224,1332,1334],{"id":1333},"update-a-template","Update a template",[208,1336,1337],{},[215,1338,1339],{},"PATCH \u002Fv1\u002Ftemplates\u002F{template}",[208,1341,1342,1343,1345,1346,1349],{},"Writes the ",[239,1344,241],{},"; emails keep using the published version. Same fields as ",[212,1347,1072],{"href":1348},"#create-a-template",", all optional: fields left out stay as they are, a blank optional field is cleared.",[1351,1352,1353],"warning",{},[208,1354,1355,1356,1358,1359,222],{},"A new ",[215,1357,331],{}," takes effect immediately: calls with the old alias get ",[215,1360,1361],{},"404",[338,1363,1365],{"className":1034,"code":1364,"language":1036,"meta":343,"style":343},"curl -X PATCH https:\u002F\u002Fapi.kulamail.com\u002Fv1\u002Ftemplates\u002Fpassword-reset \\\n  -H \"Authorization: Bearer ml_your_api_key\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{ \"subject\": \"Your password reset link\" }'\n",[215,1366,1367,1381,1393,1405],{"__ignoreMap":343},[347,1368,1369,1371,1374,1377,1379],{"class":349,"line":350},[347,1370,1043],{"class":638},[347,1372,1373],{"class":376}," -X",[347,1375,1376],{"class":376}," PATCH",[347,1378,1318],{"class":376},[347,1380,1049],{"class":562},[347,1382,1383,1385,1387,1389,1391],{"class":349,"line":357},[347,1384,1054],{"class":376},[347,1386,373],{"class":353},[347,1388,1059],{"class":376},[347,1390,367],{"class":353},[347,1392,1049],{"class":562},[347,1394,1395,1397,1399,1401,1403],{"class":349,"line":385},[347,1396,1054],{"class":376},[347,1398,373],{"class":353},[347,1400,1181],{"class":376},[347,1402,367],{"class":353},[347,1404,1049],{"class":562},[347,1406,1407,1409,1411,1414],{"class":349,"line":405},[347,1408,1190],{"class":376},[347,1410,1193],{"class":353},[347,1412,1413],{"class":376},"{ \"subject\": \"Your password reset link\" }",[347,1415,1228],{"class":353},[208,1417,1418,1419,328,1422,222],{},"Returns the template with ",[215,1420,1421],{},"status: \"UNPUBLISHED_CHANGES\"",[215,1423,1424],{},"changedFields: [\"subject\"]",[224,1426,1428],{"id":1427},"publish-a-template","Publish a template",[208,1430,1431],{},[215,1432,1433],{},"POST \u002Fv1\u002Ftemplates\u002F{template}\u002Fpublish",[208,1435,1436],{},"Copies the draft over the published version, used by the next sends. Requires a full access key.",[338,1438,1440],{"className":1034,"code":1439,"language":1036,"meta":343,"style":343},"curl -X POST https:\u002F\u002Fapi.kulamail.com\u002Fv1\u002Ftemplates\u002Fpassword-reset\u002Fpublish \\\n  -H \"Authorization: Bearer ml_your_api_key\"\n",[215,1441,1442,1456],{"__ignoreMap":343},[347,1443,1444,1446,1448,1451,1454],{"class":349,"line":350},[347,1445,1043],{"class":638},[347,1447,1373],{"class":376},[347,1449,1450],{"class":376}," POST",[347,1452,1453],{"class":376}," https:\u002F\u002Fapi.kulamail.com\u002Fv1\u002Ftemplates\u002Fpassword-reset\u002Fpublish",[347,1455,1049],{"class":562},[347,1457,1458,1460,1462,1464],{"class":349,"line":357},[347,1459,1054],{"class":376},[347,1461,373],{"class":353},[347,1463,1059],{"class":376},[347,1465,769],{"class":353},[268,1467,1468,1478],{},[271,1469,1470],{},[274,1471,1472,1474,1476],{},[277,1473,1251],{},[277,1475,1254],{},[277,1477,1257],{},[286,1479,1480,1493],{},[274,1481,1482,1484,1490],{},[291,1483,1264],{},[291,1485,1486,1239,1488],{},[215,1487,1272],{},[215,1489,1275],{},[291,1491,1492],{},"Empty content, or the sender is no longer on a verified domain",[274,1494,1495,1497,1502],{},[291,1496,1283],{},[291,1498,1499],{},[215,1500,1501],{},"nothing_to_publish",[291,1503,1504],{},"The draft has no unpublished changes",[224,1506,1508],{"id":1507},"discard-a-draft","Discard a draft",[208,1510,1511],{},[215,1512,1513],{},"POST \u002Fv1\u002Ftemplates\u002F{template}\u002Fdiscard",[208,1515,1516,1517,1519],{},"Resets the draft to the published version, dropping unpublished changes. Answers ",[215,1518,265],{}," on a template never published.",[224,1521,1523],{"id":1522},"delete-a-template","Delete a template",[208,1525,1526],{},[215,1527,1528],{},"DELETE \u002Fv1\u002Ftemplates\u002F{template}",[208,1530,1531,1532,1535,1536,222],{},"Answers ",[215,1533,1534],{},"204",". Later sends with this template get ",[215,1537,1361],{},[1539,1540,1541],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":343,"searchDepth":350,"depth":357,"links":1543},[1544,1545,1546,1547,1548,1549,1550,1551,1552],{"id":226,"depth":357,"text":227},{"id":335,"depth":357,"text":336},{"id":1022,"depth":357,"text":1023},{"id":1071,"depth":357,"text":1072},{"id":1294,"depth":357,"text":1295},{"id":1333,"depth":357,"text":1334},{"id":1427,"depth":357,"text":1428},{"id":1507,"depth":357,"text":1508},{"id":1522,"depth":357,"text":1523},"Create, edit and publish transactional templates","md",null,{},true,{"title":142,"description":1553},"zBQhv5v0gY8Mo66wsw3eDZ8d1_xH7eudZWi0qp9TlFs",[1561,1563],{"title":138,"path":139,"stem":140,"description":1562,"children":-1},"Send transactional emails, alone or in batches",{"title":42,"path":146,"stem":147,"description":1564,"children":-1},"Create and update contacts, manage subscriptions, import in bulk",1792265664033]