CINXE.COM
Automated add to calendar links for emails to create events on-the-fly.
<!DOCTYPE html> <html lang="en"> <head> <title>Automated add to calendar links for emails to create events on-the-fly.</title> <meta name="description" content="Create automated add-to-calendar links and events on-the-fly. Use on websites, newsletters and SMS/TEXT messages. Attach events in newsletters like Ex, CampaignMonitor." /> <meta property="og:title" content="AddEvent" /> <meta property="og:description" content="" /> <meta property="og:image" content="https://cdn.addevent.com/web/images/opengraph-image.png" /> <meta property="og:image:width" content="1200" /> <meta property="og:image:height" content="630" /> <!-- Icons --> <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png" /> <link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png" /> <link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png" /> <link rel="manifest" href="/site.webmanifest" /> <link rel="mask-icon" href="/safari-pinned-tab.svg" color="#125ef8" /> <meta name="msapplication-TileColor" content="#ffffff" /> <meta name="theme-color" content="#ffffff" /> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> <link rel="canonical" href="https://www.addevent.com/c/documentation/automated-add-to-calendar-links" /> <meta name="twitter:card" content="summary_large_image" /> <meta name="twitter:site" content="@AddEvent_Inc" /> <meta name="twitter:title" content="" /> <meta name="twitter:description" content="" /> <meta name="twitter:image" content="https://cdn.addevent.com/web/images/twitter-image.png" /> <!-- Critical CSS --> <style>.material-icons,[class^=icon-]{font-style:normal;text-transform:none;-webkit-font-smoothing:antialiased;font-weight:400}*{box-sizing:border-box}body,html{font-family:Circular-AddEvent,Arial,"Helvetica Neue",Helvetica,sans-serif}body,html,p{line-height:130%}a{text-decoration:none}a img{border:none}.overflow-x,body{overflow-x:hidden}body,html{height:100%;width:100%}.top,body,html{width:100%}.top{left:0;top:0}.top .menu-t1 ul{padding:0;margin:0}body,html{text-align:left}.cms .anchor{text-decoration:none!important}.code-t1 .nav{-webkit-touch-callout:none}@font-face{font-weight:400;font-style:normal;font-family:Circular-AddEvent;src:url("https://cdn.addevent.com/web/fonts/CircularXXWeb-Regular.woff2") format("woff2");font-display:swap}@font-face{font-weight:400;font-style:italic;font-family:Circular-AddEvent;src:url("https://cdn.addevent.com/web/fonts/CircularXXWeb-Italic.woff2") format("woff2");font-display:swap}@font-face{font-weight:500;font-style:normal;font-family:Circular-AddEvent;src:url("https://cdn.addevent.com/web/fonts/CircularXXWeb-Book.woff2") format("woff2");font-display:swap}@font-face{font-weight:500;font-style:italic;font-family:Circular-AddEvent;src:url("https://cdn.addevent.com/web/fonts/CircularXXWeb-BookItalic.woff2") format("woff2");font-display:swap}@font-face{font-weight:600;font-style:normal;font-family:Circular-AddEvent;src:url("https://cdn.addevent.com/web/fonts/CircularXXWeb-Medium.woff2") format("woff2");font-display:swap}@font-face{font-weight:600;font-style:italic;font-family:Circular-AddEvent;src:url("https://cdn.addevent.com/web/fonts/CircularXXWeb-MediumItalic.woff2") format("woff2");font-display:swap}@font-face{font-weight:700;font-style:normal;font-family:Circular-AddEvent;src:url("https://cdn.addevent.com/web/fonts/CircularXXWeb-Bold.woff2") format("woff2");font-display:swap}@font-face{font-weight:700;font-style:italic;font-family:Circular-AddEvent;src:url("https://cdn.addevent.com/web/fonts/CircularXXWeb-BoldItalic.woff2") format("woff2");font-display:swap}@font-face{font-family:"Material Icons";font-style:normal;font-weight:400;src:url("https://cdn.addevent.com/web/fonts/flUhRq6tzZclQEJ-Vdg-IuiaDsNc.woff2") format("woff2");font-display:swap}.material-icons{font-family:"Material Icons";font-size:"inherit";line-height:"inherit";display:inline-block;white-space:nowrap;word-wrap:normal;direction:ltr;-webkit-font-feature-settings:"liga"}@font-face{font-family:icomoon;src:url("https://cdn.addevent.com/web/fonts/icomoon.eot?7bke8f");src:url("https://cdn.addevent.com/web/fonts/icomoon.eot?7bke8f#iefix") format("embedded-opentype"),url("https://cdn.addevent.com/web/fonts/icomoon.ttf?7bke8f") format("truetype"),url("https://cdn.addevent.com/web/fonts/icomoon.woff?7bke8f") format("woff"),url("https://cdn.addevent.com/web/fonts/icomoon.svg?7bke8f#icomoon") format("svg");font-weight:400;font-style:normal;font-display:block}[class^=icon-]{font-family:icomoon!important;speak:never;font-variant:normal;line-height:1;-moz-osx-font-smoothing:grayscale}.icon-close:before{content:"\e94c";color:#125ef8}.icon-menu:before{content:"\e94d"}.icon-analytics:before{content:"\e900";color:#125ef8}.icon-automation_new:before{content:"\e901";color:#7e00e0}.icon-Chevron_Right:before{content:"\e904";color:#125ef8}.icon-document-2-2:before{content:"\e905";color:#125ef8}.icon-embedable_new:before{content:"\e906";color:#1ac67d}.icon-infinite-1:before{content:"\e907";color:#125ef8}.icon-RSVP:before{content:"\e90a";color:#e22e4e}.icon-share-event:before{content:"\e90b";color:#125ef8}.icon-subscription:before{content:"\e90c";color:#f0c322}.icon-Updates:before{content:"\e90d";color:#125ef8}body,html{margin:0;padding:0;background:#fff;font-size:16px;color:#1c212b;font-weight:400}a,p{font-size:1em;color:#1c212b}html{scroll-behavior:smooth}strong{font-weight:600}h1{margin:0;font-size:24px;line-height:135%;color:#1c212b;font-weight:700}::-webkit-input-placeholder{color:#6f7b877d;font-weight:400;font-size:1em}:-moz-placeholder{color:#6f7b877d;font-weight:400;font-size:1em}::-moz-placeholder{color:#6f7b877d;font-weight:400;font-size:1em}:-ms-input-placeholder{color:#6f7b877d;font-weight:400;font-size:1em}div::-webkit-scrollbar{background:0 0;overflow:visible;width:8px;height:8px}div::-webkit-scrollbar-thumb{background-color:rgba(0,0,0,.2);border-radius:10px}div::-webkit-scrollbar-track-piece{background-color:#fff}div::-webkit-scrollbar-corner{background:0 0}.top .menu-m .drop{right:6px;box-shadow:0 16px 24px 2px rgb(0 0 0 / 14%),0 6px 30px 5px rgb(0 0 0 / 12%),0 8px 10px -5px rgb(0 0 0 / 40%);left:6px}.top{height:76px;position:fixed;z-index:1000;background:#fffe8;border-bottom:1px solid #e8eefa}.top .pdt{padding:14px 30px 0}.top .flex{display:flex;justify-content:space-between;align-items:center}.top .logo-t1{display:flex;justify-content:center;align-items:center;max-width:168px;margin:-4px 0 0}.top .logo-t1 a{display:block;width:168px}.top .logo-t1 img{display:block;width:100%}.top .menu-m{display:none;justify-content:center;align-items:center}.top .menu-m .menu-m-btn{display:flex;justify-content:center;align-items:center;width:40px;height:40px;border:1px solid transparent!important;border-radius:50%}.top .menu-m .menu-m-btn .icon-menu:before{font-size:20px;font-weight:800}.top .menu-m .drop{flex-direction:column;position:fixed;top:6px;max-height:510px;transform:scale(1)!important;border-radius:6px;background-color:#fff;z-index:-1;opacity:0}.top .menu-m .drop .close{display:flex;justify-content:center;align-items:center;position:absolute;width:42px;height:42px;top:15px;right:17px;z-index:100;border-radius:50%}.top .menu-m .drop .close .icon-close:before{color:#000;font-size:22px;font-weight:700}.top .menu-m .drop .main{background-color:#fff;border-radius:8px;padding:22px 12px 16px;overflow-y:auto;max-height:calc(100vh - 130px)}.top .menu-m .drop .main .title{font-size:17px;line-height:1.5;font-weight:700;margin-bottom:16px;padding:0 0 0 14px}.top .menu-m .drop .main ul{list-style-type:none;padding:0;margin:0}.top .menu-m .drop .main .lst{padding-bottom:16px;border-bottom:1px solid #e5eaf3;margin-bottom:16px}.top .menu-m .drop .main .lst li:last-child a,.top .menu-m .drop .main .lst:last-child,p:last-child{margin-bottom:0}.top .menu-m .drop .main .lst li{margin:-3px 0 0}.top .menu-m .drop .main .lst li a{display:flex;position:relative;align-items:center;padding:10px 0 10px 52px;font-size:18px;line-height:1.6;border-radius:6px}.top .menu-m .drop .main .lst li a i{position:absolute;left:11px;top:11px;font-size:26px}.top .menu-m .drop .main .lst.lst-rest{padding-bottom:0;border-bottom:none}.top .menu-m .drop .main .lst.lst-rest li a{font-size:17px;line-height:1.4}.top .menu-m .drop .main .lst.lst-rest li.blk a{font-size:18px;line-height:1.6}.top .menu-m .drop .main ul li.blk{display:block}.top .menu-m .drop .main ul li.blk a{display:block;color:#000;font-size:18px;line-height:1.6}.top .menu-m .drop .ft{padding:0 8px 8px}.top .menu-m .drop .ft .btn{background:#e1e8f8;font-size:18px;line-height:1.7;font-weight:600}.top .menu-t1{padding-left:20px;padding-right:20px;margin:0 auto}.top .menu-t1 ul{display:flex;align-items:center;list-style-type:none}.top .menu-t1 ul li{position:relative;padding:0 25px}.top .menu-t1 ul li a{color:#1c212b;font-size:18px;line-height:1.6}.top .menu-t1 ul li.blk{padding:4px 6px;margin:0 0 0 24px;background-color:#1c212b;border-radius:3px}.top .menu-t1 ul li.blk a{display:block;color:#fff;font-size:12px;line-height:1.33;text-transform:uppercase}.top .menu-t1 ul li.exp a{display:flex}.top .menu-t1 ul li.exp .icon-Chevron_Right{display:block;transform:rotate(90deg);margin:2px 0 0 2px}.top .menu-t1 ul li.exp .icon-Chevron_Right::before{color:inherit}.top .drop{z-index:-1;visibility:hidden;position:absolute;max-width:1040px;left:-326px;opacity:0;transform:scale(.94);margin:-20px 0 0}.top .drop .drop-ctn{margin-top:20px;box-shadow:0 50px 100px rgb(50 50 93 / 10%),0 15px 35px rgb(50 50 93 / 15%),0 5px 15px rgb(0 0 0 / 10%);border-radius:5px;background-color:#fff}.cms,.top .drop .rl{position:relative}.top .drop .pad{padding:32px 32px 12px}.top .drop .pad .arr{position:absolute;left:380px;top:-9px;z-index:2;width:20px;height:20px;background:#fff;transform:rotate(45deg)}.top .drop .pad .hdr{color:#1c212b;font-size:22px;line-height:1.5;margin-bottom:20px;font-weight:500}.top .drop .pad .color-grid{margin-left:-12px;margin-right:-12px;gap:0}.top .drop .pad .color-grid .item{padding:20px 16px;min-width:198px;border-radius:8px;background-color:transparent}.top .drop .pad .color-grid .item .crc{background-color:#f3f7ff}.top .drop .ft .pf{padding:0 4px 4px}.top .drop .ft .pfi{padding:8px 16px 12px;border-radius:6px}.top .drop .ft .pfi ul{padding:0}.top .drop .ft .pfi ul li{margin:0;padding:0 15px 0 0}.top .drop .ft .pfi .right a,.top .drop .ft .pfi ul li a{display:flex;align-items:center;padding:8px 16px 8px 8px;border-radius:4px;background-color:transparent}.top .drop .ft .pfi .right a i,.top .drop .ft .pfi ul li a i{font-size:24px;margin-right:8px}.top .signinup{display:inline-block;font-size:15px;color:#a9acb4;padding:10px 30px;border:1px solid transparent;white-space:nowrap}.top .signinup .or{display:inline-block;padding:0 4px;font-style:italic}.top .signinup .signin{font-size:17px;font-weight:600;color:#000;font-style:normal}.cms .sed-t4 .ult1 li a{text-decoration:underline}.top .signinup .signup{font-size:17px;font-weight:500;color:#fff;font-style:normal;margin:0 0 0 4px;padding:9px 16px 9px 15px;border:1px solid transparent;background:#125ef8;border-radius:5px}.dev-cnt .left.-mobile{display:none}.dev-cnt{display:grid;width:100%}.dev-cnt .left,.dev-cnt .left.pd-bg{padding-top:100px}.dev-cnt{padding:0 64px 80px 0;grid-template-columns:20.4% calc(100% - 29.6%);column-gap:65px;position:relative}.dev-cnt .left{display:block;max-width:100%;position:relative}.dev-cnt .left.-desktop{width:264px}.dev-cnt .left .sticky-box{width:300px;display:block;position:fixed;top:76px;left:0;bottom:0;overflow:auto;background:#fff}.dev-cnt .left .list{display:block;list-style:none;margin:0;padding:24px 10px 30px 0}.dev-cnt .left .list li{padding:0;position:relative}.dev-cnt .left .list .item{display:block;width:100%;padding:8px 48px 8px 34px;position:relative;font-weight:600;font-size:16px;line-height:1.6;color:#585d69;border-radius:0 18px 18px 0}.dev-cnt .left .list .item.selected{color:#125ef8!important;background:#e8f0fe!important}.dev-cnt .left .list li .dev-arr{display:flex;align-items:center;justify-content:center;position:absolute;right:11px;top:11px}.dev-cnt .left .list li .dev-arr:before{font-size:20px;color:#cbced3}.dev-cnt .left .sublist{display:none;list-style:none;margin:0;padding:0 0 0 24px}.dev-cnt .left .sublist.active{display:block;margin:15px 0 14px 20px}.dev-cnt .left .sublist li{margin:0;padding:4px 0}.dev-cnt .left .sublist li a{font-weight:400;font-size:16px;line-height:1.6;color:#585d69}.dev-cnt>.right{display:block;width:100%;max-width:750px;padding-top:132px;position:relative}.code-t1 .nav .inm{clear:both}.cms .hed-t2 p.bld a{color:#1c212b}.cms a{color:#125ef8;font-size:inherit}.cms h1{margin-bottom:24px}.cms a.back:before{position:absolute;color:#125ef8;font-family:Icomoon}.cms a.back{display:inline-block;position:relative;padding:0 0 0 30px;margin:0 0 15px;align-items:center;font-size:17px}.cms a.back:before{display:block;left:0;top:0;transform:rotate(180deg);font-size:20px;content:"\e904"}.cms h1{font-weight:600;font-size:45px;line-height:1.17;color:#1c212b;letter-spacing:-1px}.cms .hed-t2:before{right:calc(100% + 12px);transform:translateY(-50%);content:"\e93e"}.color-grid .item.item-purple i:before{color:#7e00e0}.cms h1{padding:0 20% 0 0}.cms ul{margin:0 0 24px;padding-left:30px}.cms p{font-weight:400;line-height:1.87;color:#585d69;margin-bottom:24px;font-size:16px}.cms ul li{font-weight:400;font-size:17px;line-height:1.65;color:#1c212b}.cms p{margin-top:0}.cms .des-t1{clear:both;margin:0 0 22px}.cms .anchor{overflow-anchor:none}.cms .hed-t2{width:100%;clear:both;margin:0 0 30px;position:relative}.cms .hed-t2:before{position:absolute;top:16px;font-size:16px;font-family:Icomoon;color:#125ef8}.cms .hed-t2 p.bld{margin:0 0 24px;font-weight:600;font-size:23px;line-height:1.45;color:#1c212b;letter-spacing:0}.cms .hed-t2 p.bld em{font-size:15px;color:#444;font-weight:500}.cms .hed-t2 p{margin:0;font-size:16px;color:#333;line-height:145%}.cms .anchor{position:relative;display:block}.cms .sed-t4 .ult1 li:before{width:16px;background:#7bca00;height:10px;position:absolute;content:""}.cms .sed-t4{clear:both;position:relative;margin:0 0 48px}.cms .sed-t4 .ult1{margin:0;padding:0;list-style-type:none;font-size:17px;font-weight:700;color:#000;line-height:1.87}.cms .sed-t4 .ult1 li{position:relative;padding:0 0 0 44px;margin:0 0 20px}.cms .sed-t4 .ult1 li:before{left:12px;top:9px;border-radius:18px}.cms .sed-t4 .ult1 .sp-t1{display:block;padding:18px 0 0}.code-t1{box-shadow:0 0 0 1px rgb(50 50 93 / 5%),0 2px 5px 0 rgb(50 50 93 / 10%),0 1px 1px 0 rgb(0 0 0 / 7%)}.codemarkup{line-height:22px;font-family:monospace}.code-t1{clear:both;position:relative;border-radius:8px}.code-t1 .nav{clear:both;position:relative;padding:12px 10px 10px 12px}.code-t1 .nav .inm ul{margin:0;padding:0;list-style-type:none;font-size:0}.code-t1 .nav .inm ul li{display:inline-block;padding:0 2px 0 0}.code-t1 .nav .inm ul li a{display:inline-block;padding:0 12px;font-size:15px;text-decoration:none;line-height:32px;color:#000;font-weight:500;background:#fff;border-radius:22px}.code-t1 .nav .inm ul li .selected{color:#fff;background:#286efa}.code-t1 .code{clear:both;position:relative}.code-t1 .code .example{clear:both;height:400px;max-height:500px;overflow:auto;display:none}.code-t1 .code .autoheight{height:auto!important}.code-t1 .exmctn{border-top:1px solid #f3f3f3;border-bottom:1px solid #f3f3f3}.code-t1 .code .example .codemarkup{display:block!important}.codemarkup code em{display:inline-block;padding:0 5px;background:#ecebff;line-height:160%}.code-t1 pre::-webkit-scrollbar{background:0 0;overflow:visible;width:8px;height:8px}.code-t1 pre::-webkit-scrollbar-thumb{background-color:rgba(0,0,0,.2);border-radius:10px}.code-t1 pre::-webkit-scrollbar-track-piece{background-color:#fff}.code-t1 pre::-webkit-scrollbar-corner{background:0 0}.codemarkup{margin:0;padding:0 0 0 35px;font-size:13px;position:relative;z-index:2;color:#586e75;display:none}.miu{font-weight:400}.color-grid .item.item-red i:before{color:#e22e4e}.color-grid .item.item-yellow i:before{color:#f0c322}.breadcrumbs .bc,.breadcrumbs .bc:after{font-weight:400;font-size:17px;line-height:1.4}.breadcrumbs{display:flex;flex-wrap:wrap;margin-bottom:28px;justify-content:flex-start;align-items:center}.breadcrumbs .bc{display:flex;align-items:center;color:#125ef8}.breadcrumbs .bc:after{display:block;content:" / ";color:#aaafb8;margin:0 8px}.breadcrumbs .bc:last-of-type{color:#aaafb8;text-overflow:ellipsis}.breadcrumbs .bc:last-of-type:after{content:""}.btn,.color-grid .item.item-blue i:before{color:#125ef8}.btn{text-align:center}.btn{display:block;border:1px solid transparent;width:auto;max-height:64px;background-color:transparent;border-radius:6px;padding:12px 33px;font-size:16px;line-height:1.4;font-weight:400;white-space:nowrap}.btn-6-8{padding:6px 8px}.btn-br{border:1px solid #e1e8f8}.color-grid{display:grid;grid-template-columns:repeat(5,1fr);gap:29px}.color-grid .item{display:flex;flex-direction:column;min-width:172px;color:#1c212b;position:relative}.color-grid .item .crc{display:flex;justify-content:center;align-items:center;background-color:#f3f7ff;width:64px;min-width:64px;height:64px;min-height:64px;border-radius:50%;margin-bottom:16px}.color-grid .item .crc.crc-48{width:48px;min-width:48px;height:48px;min-height:48px}.color-grid .item .crc i{font-size:32px;font-weight:500}.color-grid .item .title{font-size:18px;line-height:1.2;margin-bottom:8px;font-weight:600}.color-grid .item p{color:#585d69;font-size:14px;line-height:1.5;margin:0 0 16px;flex:1}.color-grid .item.item-green i:before{color:#1ac67d}.brkbox-t1 .bx p{margin:0;font-size:16px;color:#394054;line-height:145%}.brkbox-t1 .bx a{text-decoration:underline;color:#394054}.brkbox-t1 .bx .ico{position:absolute;left:12px;top:11px;font-size:28px;line-height:28px;color:#f5bf59}.brkbox-t1 .bx{position:relative;padding:14px 12px 14px 52px}.brkbox-t1 .bx{border-radius:8px;clear:both}.brkbox-t1{clear:both;margin:0 0 45px}.brkbox-t1 .bx{background:#fcf9e9}.noti-wrap-t3{padding:10px 0 15px}@media all and (max-width:1440px){.dev-cnt{grid-template-columns:264px calc(100% - 376px);column-gap:112px}}@media all and (max-width:1160px){.top .menu-t1 ul li.exp .drop{max-width:900px;left:-250px}.top .drop .pad .color-grid .item{min-width:172px}.top .drop .pad .arr{position:absolute;left:380px;top:-9px}.color-grid{gap:8px}.color-grid .item{min-width:150px}}@media all and (max-width:1020px){.top .menu-t1 ul li{position:relative;padding:0 15px}.top .menu-t1 ul li a{font-size:17px}}@media all and (max-width:920px){.top .menu-t1,.top .signinup{display:none}.top .pdt{padding:20px 24px}.top .logo-t1{max-width:172px}.top .menu-m{display:flex}.bg-op,.dev-cnt .left.-desktop,.dev-cnt .right .back{display:none}.cms h1{font-weight:600}.cms ul li,.color-grid .item p{font-size:16px}.color-grid .item .crc{background:0 0}.dev-cnt{grid-template-columns:100%}.dev-cnt{padding:0 24px 64px}.dev-cnt .left.-mobile{display:block;position:fixed;width:100%;max-width:100%;background-color:#fff;left:0;top:0;z-index:3;padding-top:73px}.dev-cnt .left.-mobile .fixed-box{display:flex;width:100%;align-items:center;justify-content:space-between;border-top:1px solid transparent;padding:16px 24px}.dev-cnt .left.-mobile .fixed-box .toggle-button{font-weight:400;font-size:16px;line-height:1.6;color:#1c212b;padding:4px 12px;border:1px solid transparent;background:#e1e8f8;border-radius:3px;margin-right:16px}.dev-cnt .left.-mobile .fixed-box .breadcrumbs{margin:0}.dev-cnt .left.-mobile .fixed-box .breadcrumbs .bc{color:#585d69;font-size:16px;line-height:1.6}.dev-cnt .left.-mobile .fixed-box .breadcrumbs .bc:last-child{color:#1c212b}.dev-cnt .left.-mobile .fixed-box .breadcrumbs .bc:after{color:#585d69;margin:0 4px}.dev-cnt .left.-mobile .hidden-box{display:block;height:0;padding:0 24px;overflow-y:auto;max-height:calc(100vh - 140px)}.dev-cnt .left.-mobile .hidden-box.-start{height:auto;position:absolute;z-index:-1;left:-200%;opacity:0}.bg-op{position:fixed;left:0;top:0;right:0;bottom:0;background:#fff;opacity:.74;z-index:2}.dev-cnt .left.pd-bg{padding-top:90px}.dev-cnt>.right{padding-top:160px;margin:0 auto}.cms h1{font-size:32px}.cms .hed-t2:before{right:auto;left:0;transform:translateY(-44%)}.cms .hed-t2 p,.cms .hed-t2 p.bld{padding:0 0 0 32px}.cms .code code{padding-bottom:0}}@media all and (max-width:640px){.cms h1,.cms p{margin-bottom:16px}p:last-child{margin-bottom:0}.cms h1:not(:first-child){padding-top:16px}.btn{font-size:16px}.btn{line-height:1.5}.btn-6-8{padding:6px 8px}.color-grid .item .title{font-weight:600}.brkbox-t1 .bx p br{display:none}}@media all and (max-width:1023px){.dev-cnt{column-gap:80px}}</style> <!-- CSS --> <link rel="preload" href="https://cdn.addevent.com/web/css/style.1727971720.min.css" as="style" type="text/css" media="all" onload="this.rel='stylesheet'" /><noscript><link rel="stylesheet" href="https://cdn.addevent.com/web/css/style.1727971720.min.css" type="text/css" media="all" /></noscript> <script type="text/javascript"> const apiKey = "7c83cdd9bbfa097ae9efd1ac2a5adc93"; const amplitudeIdentifier = ""; const stripeApiKey = "pk_live_51CXIGHFQZnNN5IkD9v3V5sPzP4rGlTFiwQvLUNeFqmDjobSbvvnWN8jLqbJIhy0kpxfXIbEtCC8qNJwKQGIqEl8z00IhsuKE5r"; </script> <script> (function(w){w.fpr=w.fpr||function(){w.fpr.q = w.fpr.q||[];w.fpr.q[arguments[0]=='set'?'unshift':'push'](arguments);};})(window); fpr("init", {cid:'iv10gft5'}); fpr("click"); </script> <script src="https://cdn.firstpromoter.com/fpr.js" async></script> <script src="https://cdn.addevent.com/libs/ref/aetrack.20240418.prod.js" crossorigin="anonymous" async></script> </head> <body id="doc" class=""> <div class="overflow-x"> <div class="top"> <div class="pdt"> <div class="flex"> <div class="logo-t1"> <a href="/" title="Home"> <picture> <img src="https://cdn.addevent.com/web/images/logo-t1.svg" width="168" height="38" alt="AddEvent" /> </picture> </a> </div> <div class="menu-t1"> <div class="list"> <ul> <li class="exp"> <a href="#" title="" class="solexp">Solutions <i class="icon-Chevron_Right"></i></a> <div class="drop" data-open="false"> <div class="drop-ctn"> <div class="rl"> <div class="pad"> <div class="arr"></div> <div class="hdr"> Discover our solutions </div> <div class="color-grid"> <a href="/solutions/share-events" title="Share events" class="link"> <div class="item item-blue"> <div class="crc crc-48"> <i class="icon-share-event"></i> </div> <div class="title"> Share <br /> events </div> <p> Get your events onto your users' calendars. </p> </div> </a> <a href="/solutions/collect-rsvp-events" title="Collect RSVPs" class="link"> <div class="item item-red"> <div class="crc crc-48"> <i class="icon-RSVP"></i> </div> <div class="title"> Collect <br /> RSVPs </div> <p> Collect information from your attendees when they register for your events. </p> </div> </a> <a href="/solutions/subscription-calendars" title="Subscription calendars" class="link"> <div class="item item-yellow"> <div class="crc crc-48"> <i class="icon-subscription"></i> </div> <div class="title"> Subscription <br /> calendar </div> <p> Share multiple events at once with a calendar your users can subscribe to. </p> </div> </a> <a href="/solutions/embeddable-calendar" title="Embeddable calendar" class="link"> <div class="item item-green"> <div class="crc crc-48"> <i class="icon-embedable_new"></i> </div> <div class="title"> Embeddable <br /> calendar </div> <p> Embed a calendar on your website to display and share your events. </p> </div> </a> <a href="/solutions/automated-events" title="Automated events" class="link"> <div class="item item-purple"> <div class="crc crc-48"> <i class="icon-automation_new"></i> </div> <div class="title"> Automated <br /> events </div> <p> Share high volumes of events that can be dynamically updated. </p> </div> </a> </div> </div> <div class="ft"> <div class="pf"> <div class="pfi"> <div class="flex"> <ul> <li><a href="/c/documentation" title="Documentation"><i class="icon-document-2-2"></i>Documentation</a></li> <li><a href="/integrations" title="Integrations"><i class="icon-infinite-1"></i>Integrations</a></li> <li><a href="https://help.addevent.com/changelog" title="Updates" target="_blank"><i class="icon-Updates"></i>Updates</a></li> </ul> <div class="right"> <a href="/solutions/analytics" title="Analytics" class="btn btn-6-8"><i class="icon-analytics"></i>Analytics</a> </div> </div> </div> </div> </div> </div> </div> </div> </li> <li><a href="/c/plans-and-pricing" title="Plans and pricing">Pricing</a></li> <li><a href="/blog" title="Blog">Blog</a></li> <li class="blk"><a href="/c/documentation" title="Documentation for developers">FOR DEVS</a></li> </ul> </div> </div> <div class="right"> <div class="signinup"> <a href="https://app.addevent.com" title="Sign In" class="signin">Sign In</a> <span class="or">or</span> <a href="https://app.addevent.com/signup" title="Sign Up" class="signup">Sign Up</a> </div> <div class="menu-m"> <div class="menu-m-btn"> <i class="icon-menu"></i> </div> <div class="drop"> <div class="close"> <i class="icon-close"></i> </div> <div class="main"> <div class="title solexp">Solutions</div> <ul class="lst"> <li><a href="/solutions/share-events" title="Share events"><i class="icon-share-event"></i>Share events</a></li> <li><a href="/solutions/collect-rsvp-events" title="Collect RSVPs"><i class="icon-RSVP"></i>Collect RSVPs</a></li> <li><a href="/solutions/subscription-calendars" title="Subscription calendars"><i class="icon-subscription"></i>Subscription calendar</a></li> <li><a href="/solutions/embeddable-calendar" title="Embeddable calendar"><i class="icon-embedable_new"></i>Embeddable calendar</a></li> <li><a href="/solutions/automated-events" title="Automated events"><i class="icon-automation_new"></i>Automated events</a></li> </ul> <ul class="lst"> <li><a href="/solutions/analytics" title="Analytics"><i class="icon-analytics"></i>Analytics</a></li> <li><a href="/integrations" title="Integrations"><i class="icon-Updates"></i>Integrations</a></li> <li><a href="https://help.addevent.com/changelog" title="Updates" target="_blank"><i class="icon-infinite-1"></i>Updates</a></li> <li><a href="/c/documentation" title="Documentation"><i class="icon-document-2-2"></i>Documentation</a></li> </ul> <ul class="lst lst-rest"> <li><a href="/c/plans-and-pricing" title="Pricing">Pricing</a></li> <li><a href="/blog" title="Blog">Blog</a></li> <li class="blk"><a href="/c/documentation" title="Documentation for developers">FOR DEVS</a></li> </ul> </div> <div class="ft"> <a href="/signin" title="Go to app" class="btn btn-br">Go to app</a> </div> </div> </div> </div> </div> </div> </div> <div class="bg-op"></div> <div class="dev-cnt"> <!-- Mobile menu --> <div class="left -mobile"> <div class="fixed-box"> <div class="toggle-button">Menu</div> <div class="breadcrumbs"> <a href="/c/documentation" title="Documentation" class="bc">Documentation</a> <a title="" class="bc">Add to calendar links</a> </div> </div> <div class="hidden-box -start" id="moblftmnu"></div> </div> <!-- Desktop menu --> <div class="left -desktop pd-bg"> <div class="sticky-box" id="desklftmnu"> <ul class="list"> <li> <a href="/c/documentation/add-to-calendar-button" class="item">Automated add to calendar button for websites</a> <i class="icon-Chevron_Right dev-arr"></i> <ul class="sublist"> <li><a href="#anchor-install" title="" data-rel="install" class="anchor">Install, parameters and attributes</a></li> <li><a href="#anchor-advanced-settings" title="" data-rel="advanced-settings" class="anchor">Advanced settings</a></li> <li><a href="#anchor-event-listeners" title="" data-rel="event-listeners" class="anchor">Event listeners</a></li> <li><a href="#anchor-themes" title="" data-rel="themes" class="anchor">Themes</a></li> <li><a href="#anchor-product" title="" data-rel="product" class="anchor">Product specification</a></li> <li><a href="#anchor-faq" title="" data-rel="faq" class="anchor">Questions and answers</a></li> </ul> </li> <li> <a href="/c/documentation/automated-add-to-calendar-links" class="item selected">Automated add to calendar links for emails </a> <i class="icon-Chevron_Right dev-arr"></i> <ul class="sublist active"> <li><a href="#anchor-ontheflypage" title="" data-rel="ontheflypage" class="anchor">Create an event on-the-fly (endpoint: event page)</a></li> <li><a href="#anchor-ontheflycal" title="" data-rel="ontheflycal" class="anchor">Create an event on-the-fly (endpoint: calendar service)</a></li> <li><a href="#anchor-attach" title="" data-rel="attach" class="anchor">Attach an event in newsletters</a></li> <li><a href="#anchor-parameters" title="" data-rel="parameters" class="anchor">Parameters</a></li> </ul> </li> <li> <a href="/c/documentation/calendar-events-api" class="item">Calendar & Events API <span class="vea">v2</span></a> <i class="icon-Chevron_Right dev-arr"></i> </li> <li> <a href="/c/documentation/calendar-api" class="item">Calendar API <span class="veb">Deprecated</span></a></a> <i class="icon-Chevron_Right dev-arr"></i> <ul class="sublist"> <li><a href="#anchor-calendar-list" title="" data-rel="calendar-list" class="anchor">List calendars</a></li> <li><a href="#anchor-calendar-create" title="" data-rel="calendar-create" class="anchor">Create a calendar</a></li> <li><a href="#anchor-calendar-save" title="" data-rel="calendar-save" class="anchor">Save a calendar</a></li> <li><a href="#anchor-calendar-delete" title="" data-rel="calendar-delete" class="anchor">Delete a calendar</a></li> <li><a href="#anchor-calendar-events" title="" data-rel="calendar-events" class="anchor">List events in a calendar</a></li> <li><a href="#anchor-calendar-all-events" title="" data-rel="calendar-all-events" class="anchor">List all events across all calendars</a></li> <li><a href="#anchor-calendar-event-create" title="" data-rel="calendar-event-create" class="anchor">Create an event in a calendar</a></li> <li><a href="#anchor-calendar-event-save" title="" data-rel="calendar-event-save" class="anchor">Save an event in a calendar</a></li> <li><a href="#anchor-calendar-event-delete" title="" data-rel="calendar-event-delete" class="anchor">Delete an event in a calendar</a></li> <li><a href="#anchor-subscribers-list" title="" data-rel="subscribers-list" class="anchor">List calendar subscribers</a></li> <li><a href="#anchor-subscribers-subscriber" title="" data-rel="subscribers-subscriber" class="anchor">View a subscriber</a></li> <li><a href="#anchor-subscribers-subscriber-delete" title="" data-rel="subscribers-subscriber-delete" class="anchor">Delete a subscriber</a></li> <li><a href="#anchor-timezones" title="" data-rel="timezones" class="anchor">List of time zones</a></li> </ul> </li> <li> <a href="/c/documentation/events-api" class="item">Events API <span class="veb">Deprecated</span></a></a> <i class="icon-Chevron_Right dev-arr"></i> <ul class="sublist"> <li><a href="#anchor-events-list" title="" data-rel="events-list" class="anchor">List events</a></li> <li><a href="#anchor-event-create" title="" data-rel="event-create" class="anchor">Create an event</a></li> <li><a href="#anchor-event-save" title="" data-rel="event-save" class="anchor">Save an event</a></li> <li><a href="#anchor-event-delete" title="" data-rel="event-delete" class="anchor">Delete an event</a></li> <li><a href="#anchor-event-view" title="" data-rel="event-view" class="anchor">View an event</a></li> <li><a href="#anchor-rsvp-list" title="" data-rel="rsvp-list" class="anchor">List RSVP's of an event</a></li> <li><a href="#anchor-rsvp-attendee" title="" data-rel="rsvp-attendee" class="anchor">View an RSVP attendee</a></li> <li><a href="#anchor-rsvp-attendee-create" title="" data-rel="rsvp-attendee-create" class="anchor">Create an RSVP attendee</a></li> <li><a href="#anchor-rsvp-attendee-save" title="" data-rel="rsvp-attendee-save" class="anchor">Save an RSVP attendee</a></li> <li><a href="#anchor-timezones" title="" data-rel="timezones" class="anchor">List of time zones</a></li> </ul> </li> <li> <a href="/c/documentation/tools/recurring-rule-generator" class="item">Useful Tools</a> <i class="icon-Chevron_Right dev-arr"></i> <ul class="sublist"> <li><a href="/c/documentation/tools/recurring-rule-generator" title="">Recurring Rule generator</a></li> <li><a href="/c/documentation/tools/time-zone-lookup" title="">Time zone lookup</a></li> </ul> </li> </ul> </div> </div> <!-- Content --> <div class="right cms"> <a href="/c/documentation" class="back">Back to Documentation</a> <h1>Automated add to calendar links for emails</h1> <div class="des-t1"> <p> This tool is a link with customizable parameters that can be used to create an event on-the-fly, or send your users to their calendar service where they can add your event, or attach your event to an email you send to your users. </p> </div> <div class="noti-wrap-t3"> <div class="brkbox-t1"> <div class="bx"> <p> The API requires an API token to work. <br /> Please <a href="/signin" title="">sign in</a> or <a href="/signup" title="">create an account</a> to receive your accounts API tokens. </p> <i class="ico material-icons">lock_open</i> </div> </div> </div> <div class="sed-t4"> <ul class="ult1"> <li> Create an <strong class="miu">add to calendar link</strong> in e.g. newsletters. The link redirects your user to an event page. <br /> <a title="" onclick="window.open('https://www.addevent.com/dir/?client=USER-CLIENT-ID&start=12%2F07%2F2024+09%3A00+AM&end=12%2F07%2F2024+11%3A00+AM&title=Title+of+the+event&description=Description+of+the+event&location=1600+Amphitheatre+Pkwy%2C+Mountain+View%2C+CA+94043&timezone=America%2FLos_Angeles');">Add event to your calendar</a> </li> <li> Create an add to calendar link in e.g. newsletters. The link redirects to the specified service. <br /> <span class="sp-t1">Add event to your calendar:</span> <a title="" onclick="window.open('https://www.addevent.com/dir/?client=USER-CLIENT-ID&start=12%2F07%2F2024+09%3A00+AM&end=12%2F07%2F2024+11%3A00+AM&title=Title+of+the+event&description=Description+of+the+event&location=1600+Amphitheatre+Pkwy%2C+Mountain+View%2C+CA+94043&timezone=America%2FLos_Angeles&service=apple');">Apple</a> <a title="" onclick="window.open('https://www.addevent.com/dir/?client=USER-CLIENT-ID&start=12%2F07%2F2024+09%3A00+AM&end=12%2F07%2F2024+11%3A00+AM&title=Title+of+the+event&description=Description+of+the+event&location=1600+Amphitheatre+Pkwy%2C+Mountain+View%2C+CA+94043&timezone=America%2FLos_Angeles&service=google');">Google</a> <a title="" onclick="window.open('https://www.addevent.com/dir/?client=USER-CLIENT-ID&start=12%2F07%2F2024+09%3A00+AM&end=12%2F07%2F2024+11%3A00+AM&title=Title+of+the+event&description=Description+of+the+event&location=1600+Amphitheatre+Pkwy%2C+Mountain+View%2C+CA+94043&timezone=America%2FLos_Angeles&service=office365');">Office 365</a> <a title="" onclick="window.open('https://www.addevent.com/dir/?client=USER-CLIENT-ID&start=12%2F07%2F2024+09%3A00+AM&end=12%2F07%2F2024+11%3A00+AM&title=Title+of+the+event&description=Description+of+the+event&location=1600+Amphitheatre+Pkwy%2C+Mountain+View%2C+CA+94043&timezone=America%2FLos_Angeles&service=outlook');">Outlook</a> <a title="" onclick="window.open('https://www.addevent.com/dir/?client=USER-CLIENT-ID&start=12%2F07%2F2024+09%3A00+AM&end=12%2F07%2F2024+11%3A00+AM&title=Title+of+the+event&description=Description+of+the+event&location=1600+Amphitheatre+Pkwy%2C+Mountain+View%2C+CA+94043&timezone=America%2FLos_Angeles&service=outlookcom');">Outlook.com</a> <a title="" onclick="window.open('https://www.addevent.com/dir/?client=USER-CLIENT-ID&start=12%2F07%2F2024+09%3A00+AM&end=12%2F07%2F2024+11%3A00+AM&title=Title+of+the+event&description=Description+of+the+event&location=1600+Amphitheatre+Pkwy%2C+Mountain+View%2C+CA+94043&timezone=America%2FLos_Angeles&service=yahoo');">Yahoo</a> </li> <li> Attach an event file in e.g. newsletters/reminders using your existing Mail API. See example below for details. </li> </ul> </div> <div class="hed-t2"> <p class="bld"><a id="anchor-ontheflypage" class="anchor">Create an event on-the-fly <em>(endpoint: event page)</em></a></p> <p> Creates an event on-the-fly. The users end up on an event page. </p> </div> <!-- Example --> <div class="code-t1" id="codebox1" data-active-id="exm1"> <div class="nav"> <div class="inm"> <ul> <li><a href="#" title="" data-view="code" data-box="codebox1" class="selected">URL</a></li> <li><a href="#" title="" data-view="example" data-box="codebox1">Example with data</a></li> </ul> </div> </div> <div class="code"> <!-- Code --> <div id="exm1" class="exmctn"> <!-- Code --> <pre class="codemarkup exst1"><code><a href="https://www.addevent.com/dir/?client=<em>CLIENT</em>&start=<em>start</em>&end=<em>end</em>&title=<em>title</em>&timezone=<em>timezone</em>">Add to Calendar</a> </code></pre> <!-- Code with data --> <div class="example autoheight"> <!-- Code --> <pre class="codemarkup exst1"><code><a href="https://www.addevent.com/dir/?client=USER-CLIENT-ID&start=12%2F07%2F2024+09%3A00+AM&end=12%2F07%2F2024+11%3A00+AM&title=Title+of+the+event&description=Description+of+the+event&location=1600+Amphitheatre+Pkwy%2C+Mountain+View%2C+CA+94043&timezone=America%2FLos_Angeles">Add to Calendar</a> </code></pre> </div> </div> </div> </div> <!-- Try it out --> <div class="sep-t1"></div> <div class="hed-t2"> <p class="bld"><a id="anchor-ontheflycal" class="anchor">Create an event on-the-fly <em>(endpoint: calendar service)</em></a></p> <p> Creates an event on-the-fly. Downloads an event file or redirects the user to the calendar client. </p> </div> <!-- Example --> <div class="code-t1" id="codebox2" data-active-id="exm2"> <div class="nav"> <div class="inm"> <ul> <li><a href="#" title="" data-view="code" data-box="codebox2" class="selected">URL</a></li> <li><a href="#" title="" data-view="example" data-box="codebox2">Example with data</a></li> </ul> </div> </div> <div class="code"> <!-- Code --> <div id="exm2" class="exmctn"> <!-- Code --> <pre class="codemarkup exst1"><code>Add to Calendar: <a href="https://www.addevent.com/dir/?client=<em>CLIENT</em>&start=<em>start</em>&end=<em>end</em>&title=<em>title</em>&timezone=<em>timezone</em>&service=<em>service</em>">Link Text</a> </code></pre> <!-- Code with data --> <div class="example autoheight"> <!-- Code --> <pre class="codemarkup exst1"><code>Add to Calendar: <a href="https://www.addevent.com/dir/?client=USER-CLIENT-ID&start=12%2F07%2F2024+09%3A00+AM&end=12%2F07%2F2024+11%3A00+AM&title=Title+of+the+event&description=Description+of+the+event&location=1600+Amphitheatre+Pkwy%2C+Mountain+View%2C+CA+94043&timezone=America%2FLos_Angeles&service=apple">Apple</a> <a href="https://www.addevent.com/dir/?client=USER-CLIENT-ID&start=12%2F07%2F2024+09%3A00+AM&end=12%2F07%2F2024+11%3A00+AM&title=Title+of+the+event&description=Description+of+the+event&location=1600+Amphitheatre+Pkwy%2C+Mountain+View%2C+CA+94043&timezone=America%2FLos_Angeles&service=google">Google</a> <a href="https://www.addevent.com/dir/?client=USER-CLIENT-ID&start=12%2F07%2F2024+09%3A00+AM&end=12%2F07%2F2024+11%3A00+AM&title=Title+of+the+event&description=Description+of+the+event&location=1600+Amphitheatre+Pkwy%2C+Mountain+View%2C+CA+94043&timezone=America%2FLos_Angeles&service=office365">Office 365</a> <a href="https://www.addevent.com/dir/?client=USER-CLIENT-ID&start=12%2F07%2F2024+09%3A00+AM&end=12%2F07%2F2024+11%3A00+AM&title=Title+of+the+event&description=Description+of+the+event&location=1600+Amphitheatre+Pkwy%2C+Mountain+View%2C+CA+94043&timezone=America%2FLos_Angeles&service=outlook">Outlook</a> <a href="https://www.addevent.com/dir/?client=USER-CLIENT-ID&start=12%2F07%2F2024+09%3A00+AM&end=12%2F07%2F2024+11%3A00+AM&title=Title+of+the+event&description=Description+of+the+event&location=1600+Amphitheatre+Pkwy%2C+Mountain+View%2C+CA+94043&timezone=America%2FLos_Angeles&service=outlookcom">Outlook.com</a> <a href="https://www.addevent.com/dir/?client=USER-CLIENT-ID&start=12%2F07%2F2024+09%3A00+AM&end=12%2F07%2F2024+11%3A00+AM&title=Title+of+the+event&description=Description+of+the+event&location=1600+Amphitheatre+Pkwy%2C+Mountain+View%2C+CA+94043&timezone=America%2FLos_Angeles&service=yahoo">Yahoo</a> </code></pre> </div> </div> </div> </div> <!-- Try it out --> <div class="sep-t1"></div> <div class="hed-t2"> <p class="bld"><a id="anchor-attach" class="anchor">Attach an event in newsletters</a></p> <p> If you send emails using a Mail API or your own code you can attach an event file in an email. <br /> In the example you'll find an example on how to attach an event using the Mandrill Mail API. <br /> The same technique can be applied to almost any other service used for sending out emails. </p> </div> <!-- Example --> <div class="code-t1" id="codebox3" data-active-id="exm3"> <div class="nav"> <div class="inm"> <ul> <li><a href="#" title="" data-view="code" data-box="codebox3" class="selected">URL</a></li> <li><a href="#" title="" data-view="example" data-box="codebox3">Mandrill API (PHP example)</a></li> </ul> </div> </div> <div class="code"> <!-- Code --> <div id="exm3" class="exmctn"> <!-- Code --> <pre class="codemarkup exst1"><code>https://www.addevent.com/dir/?client=<em>CLIENT</em>&start=<em>start</em>&end=<em>end</em>&title=<em>title</em>&description=<em>description</em>&timezone=<em>timezone</em>&service=<em>stream</em> </code></pre> <!-- Code with data --> <div class="example autoheight"> <!-- Code --> <pre class="codemarkup exst1"><code>// Get event file for attachment $attachment = file_get_contents('https://www.addevent.com/dir/? client=USER-CLIENT-ID&start=12%2F07%2F2024+09%3A00+AM& end=12%2F07%2F2024+11%3A00+AM&title=Title+of+the+event& description=Description+of+the+event&timezone=America%2FLos_Angeles& service=stream'); // Event file: Base 64 encode the event file $attachment_encoded = base64_encode($attachment); // Set message object $compose = array( 'html' => 'Email content', 'subject' => 'Email subject', 'from_email' => 'from@example.com', 'to' => array( array( 'email' => 'to@example.com' ) ), 'attachments' => array( array( 'content' => $attachment_encoded, 'type' => 'text/calendar', 'name' => 'event.ics', ) ) ); // Send the email $response = $mandrill->messages->send($compose); </code></pre> </div> </div> </div> </div> <div class="sep-t1"></div> <div class="zig-t1"> <div class="bg"></div> </div> <div class="sep-t2"></div> <div class="hed-t2"> <p class="bld"><a id="anchor-parameters" class="anchor">Parameters</a></p> </div> <!-- Parameter box --> <div class="parambox-t1"> <div class="params-t1"> <div class="row"> <div class="th th1"> Parameter </div> <div class="th th2"> Description </div> </div> <div class="row"> <div class="td td1"> client </div> <div class="td td2"> <span class="required-t1">Required</span><br /><br /> Account client ID. The account client ID is available in the <a href="/account" title="">Account</a> section and is incorporated in all code examples on this page. </div> </div> <div class="row"> <div class="td td1"> start </div> <div class="td td2"> <span class="required-t1">Required</span><br /><br /> Start date of the event. Accepts most date/time formats, e.g. <span class="markup-t3">11/23/2024 03:00 PM</span> (12-hour format) or <span class="markup-t3">23-11-2024 15:00</span> (24-hour format). <br /><br /> Use numeric values to describe the date, e.g. "" and <em>not</em> textual, e.g. "". <br /><br /> Dates in the m/d/y or d-m-y formats are disambiguated by looking at the separator between the various components: if the separator is a slash (/), then the American m/d/y is assumed; whereas if the separator is a dash (-) or a dot (.), then the European d-m-y format is assumed. If, however, the year is given in a two digit format and the separator is a dash (-, the date string is parsed as y-m-d. To avoid potential ambiguity, it's best to use ISO 8601 (YYYY-MM-DD) dates<br /><br /> Date examples:<br /> <span class="markup-t3">11/23/2024 03:00 PM</span> or <span class="markup-t3">23-11-2024 15:00</span> or <span class="markup-t3">2024/11/23 03:00 PM</span> or <span class="markup-t3">2024-11-23 15:00</span> </div> </div> <div class="row"> <div class="td td1"> end </div> <div class="td td2"> End date of the event. Accepts most date/time formats, e.g. <span class="markup-t3">11/23/2024 05:00 PM</span> (12-hour format) or <span class="markup-t3">23-11-2024 17:00</span> (24-hour format). <br /><br /> Use numeric values to describe the date, e.g. "" and <em>not</em> textual, e.g. "". <br /><br /> Dates in the m/d/y or d-m-y formats are disambiguated by looking at the separator between the various components: if the separator is a slash (/), then the American m/d/y is assumed; whereas if the separator is a dash (-) or a dot (.), then the European d-m-y format is assumed. If, however, the year is given in a two digit format and the separator is a dash (-, the date string is parsed as y-m-d. To avoid potential ambiguity, it's best to use ISO 8601 (YYYY-MM-DD) dates<br /><br /> Date examples:<br /> <span class="markup-t3">11/23/2024 05:00 PM</span> or <span class="markup-t3">23-11-2024 17:00</span> or <span class="markup-t3">2024/11/23 05:00 PM</span> or <span class="markup-t3">2024-11-23 17:00</span> <br /><br /> If <span class="markup-t2">end</span> is not defined, the end date is automatically set to <span class="markup-t2">start</span> date plus one hour. </div> </div> <div class="row"> <div class="td td1"> duration </div> <div class="td td2"> Duration of the event in minutes, e.g. "30". Ignores the <span class="markup-t2">end</span> date if set and adds the minutes to the <span class="markup-t2">start</span> date. </div> </div> <div class="row"> <div class="td td1"> title </div> <div class="td td2"> <span class="required-t1">Required</span><br /><br /> Title of the event. Single line string. </div> </div> <div class="row"> <div class="td td1"> description </div> <div class="td td2"> Description of the event. Use <br> or \n to separate lines. <br /><br /> The field accepts plain text or simplified HTML. Simplified HTML is supported by calendar clients like Outlook and Apple Calendar. If the calendar client does accept HTML, the content of the field is automatically converted into readable text. <br /><br /> Keep the description short and to the point. Link to a website for further details if the event description is long. Maximum 500 characters recommended. <br /><br /> <em>Reason: Most modern browsers allow an unlimited number of characters to be transferred by the browser. Internet Explorer / Edge only allows ~2000 characters. A 500 characters maximum is recommended to make sure your event is cross browser compatible.</em> <br /><br /> For the "Outlook.com" and "Office 365" options the description is automatically truncated after 700 characters when not using the Microsoft Events API version. The reason is that longer descriptions (unfortunately) will make Microsoft's Calendar services fail. </div> </div> <div class="row"> <div class="td td1"> location </div> <div class="td td2"> Event location, eg. "Eiffel Tower, Paris". </div> </div> <div class="row"> <div class="td td1"> organizer </div> <div class="td td2"> Event organizer, e.g. "John Johnson". <br /><br /> If you fill out <span class="markup-t2">organizer</span> you must also include the <span class="markup-t2">organizer_email</span> field. <br /><br /> If you include an <span class="markup-t2">organizer</span> and an <span class="markup-t2">organizer_email</span>, the event is considered to be a "meeting" by calendar clients like Outlook. If you don't include the fields, the event is considered to be an "appointment". </div> </div> <div class="row"> <div class="td td1"> organizer_email </div> <div class="td td2"> Event organizer e-mail, e.g. "your@email.com".<br /><br /> If you fill out <span class="markup-t2">organizer_email</span> you must also include the <span class="markup-t2">organizer</span> field. <br /><br /> If you include an <span class="markup-t2">organizer</span> and an <span class="markup-t2">organizer_email</span>, the event is considered to be a "meeting" by calendar clients like Outlook. If you don't include the fields, the event is considered to be an "appointment". </div> </div> <div class="row"> <div class="td td1"> all_day_event </div> <div class="td td2"> All day event. Accepts <span class="markup-t3">true</span> or <span class="markup-t3">false</span>. </div> </div> <div class="row"> <div class="td td1"> date_format </div> <div class="td td2"> The format of the date in <span class="markup-t2">start</span> and <span class="markup-t2">end</span>. Accepts the values <span class="markup-t3">MM/DD/YYYY</span> or <span class="markup-t3">DD/MM/YYYY</span> only. Lets the engine know how to handle the date, e.g. 12-hour format (MM/DD/YYYY) or 24-hour format (DD/MM/YYYY).<br /><br /> <em>The date_format used to be mandatory but is optional today.</em> </div> </div> <div class="row"> <div class="td td1"> timezone </div> <div class="td td2"> The events time zone, e.g. <span class="markup-t3">Europe/Paris</span> or <span class="markup-t3">America/Los_Angeles</span>. <br /><br /> If <span class="markup-t2">timezone</span> is applied (recommended), date/time will be converted to Zulu time / GMT / UTC. If timezone is not applied, date/time will be parsed as is (fluid date/time).<br /><br /> <em>Explanation: The timezone parameter makes sure the date/time is correct no matter if you are in New York or Sydney. If your event has users from multiple time zones in the world, it's highly recommended to use the parameter.</em> </div> </div> <div class="row"> <div class="td td1"> reference </div> <div class="td td2"> Value to keep track of events. Used for statistics. E.g. "iPhone" or "Newsletter Oct 2016" or URL reference. </div> </div> <div class="row"> <div class="td td1"> linkback </div> <div class="td td2"> In case an event description is truncated it can be useful to provide a link back to a full event details page. If the linkback property contains any information AND the event description has been truncated the linkback property is added after the truncated event description. </div> </div> <div class="row"> <div class="td td1"> service </div> <div class="td td2"> Accepts: <span class="markup-t3">apple</span> or <span class="markup-t3">google</span> or <span class="markup-t3">office365</span> or <span class="markup-t3">outlook</span> or <span class="markup-t3">outlookcom</span> or <span class="markup-t3">yahoo</span> or <span class="markup-t3">stream</span>.<br /><br /> If a service is specified, e.g. "apple" the event will be downloaded immediately to the users computer/device. If <span class="markup-t2">service</span> isn't defined, the user will be redirected to an event page. Example: https://www.addevent.com/event/?db52444.<br /><br /> Use the value <span class="markup-t2">stream</span> if you want to attach event files in your existing Mail API. </div> </div> <div class="row"> <div class="td td1"> template </div> <div class="td td2"> Id of a "Custom Event Page" template, e.g. "lm2015e14o720j11". Uses the "AddEvent default" template if <span class="markup-t2">template</span> is not defined. <br /> In order to create/access custom templates please go to "Events" -> "New Event" and save it. Then scroll down the page and click the "Custom template" button. With "Custom templates" you can edit all HTML of the event page, change date formats (e.g. 24-hour clock) etc. </div> </div> <div class="row"> <div class="td td1"> alarm </div> <div class="td td2"> Event reminder. Trigger an event reminder e.g. "15" minutes before the event starts. <br /> Accepted input: Number <br /><br /> Example: Reminder "15" minutes before event starts = <span class="markup-t3">15</span> or <br /> one day before event starts : 60 minutes x 24 hours = <span class="markup-t3">1440</span>.<br /><br /> Event reminders are currently supported by:<br /> - Apple Calendar<br /> - Google Calendar <em>(using Google Events API)</em><br /> - Outlook<br /> - Outlook.com <em>(using Microsoft Events API)</em> </div> </div> <div class="row"> <div class="td td1"> recurring </div> <div class="td td2"> Recurring rule, e.g. <span class="markup-t3">FREQ=WEEKLY;UNTIL=20241110T080000Z;BYDAY=WE,TH,FR</span> <br /> Make the event repeat for a number of times. <br /><br /> <a href="#" title="" class="rrulegeneratewindow">Generate Recurring Rule<span class="material-icons">build</span></a> <br /><br /> Recurring rules are advanced and needs to be tested before you publish it. Please notice: The start date/time must match the recurrence rule in order to work in strict calendar systems like Outlook and Apple Calendar. <br /><br /> Recurring rules are currently supported by:<br /> - Apple Calendar<br /> - Google Calendar <em>(using "Direct" and Google Events API)</em><br /> - Office 365 (using the Microsoft Events API)<br /> - Outlook<br /> - Outlook.com <em>(using Microsoft Events API)</em> </div> </div> <div class="row"> <div class="td td1"> calname </div> <div class="td td2"> Custom filenaming of the .ics file used for e.g. Outlook and Apple Calendar. If not defined the name defaults to "event.ics". Use the phrase <span class="markup-t3">use-title</span> to use the title from the <span class="markup-t2">title</span> parameter or enter a custom filename. </div> </div> <div class="row"> <div class="td td1"> attendees </div> <div class="td td2"> Add one or multiple attendees (pre-populated) to the event. Enables the pre-populated attendee(s) to get a response from the attendee. Separate multiple attendees (email addresses) with a comma. <br /><br /> Examples:<br /> <span class="markup-t3">joe@example.com</span> or <span class="markup-t3">joe@example.com,jack@example.com</span> </div> </div> <div class="row"> <div class="td td1"> uid </div> <div class="td td2"> Define your own UID for the event. If not defined, a system UID is generated. Please notice; Yahoo Calendar reports error 404 if an UID is defined. We therefore don't include UID's in Yahoo Calendar. <br /><br /> <em>Warning. Use this option only if it serves a purpose in your coding.</em> </div> </div> <div class="row"> <div class="td td1"> status </div> <div class="td td2"> Define the status parameter in the .ics file used for e.g. Outlook and Apple Calendar. The options can be <span class="markup-t3">CONFIRMED</span>, <span class="markup-t3">TENTATIVE</span>, <span class="markup-t3">CANCELLED</span>, <span class="markup-t3">NEEDS-ACTION</span>, <span class="markup-t3">COMPLETED</span>, <span class="markup-t3">IN-PROCESS</span> according to the iCalendar guidelines. <br />If the value is not defined (recommended), the system defaults to "CONFIRMED". <br /><br /> <em>Warning. Use this option only if it serves a purpose in your coding.</em> </div> </div> <div class="row"> <div class="td td1"> method </div> <div class="td td2"> If defined, a method parameter is added in the .ics file used by e.g. Outlook and Apple Calendar. If not defined, no method parameter is added in the .ics file. http://www.kanzaki.com/docs/ical/method.html + https://tools.ietf.org/html/rfc2446 <br /><br /> Examples of usage:<br /> <span class="markup-t3">PUBLISH</span>, <span class="markup-t3">REQUEST</span>, <span class="markup-t3">CANCEL</span>, <span class="markup-t3">"REFRESH"</span>. <br /><br /> <em>Warning. Use this option only if it serves a purpose in your coding.</em> </div> </div> <div class="row"> <div class="td td1"> transp </div> <div class="td td2"> <span class="markup-t1"><span class="transp">TRANSPARENT</span></span><br /><br /> Determines whether the event appears as "free" or "busy" on the users calendar. Default value is <span class="markup-t3">OPAQUE</span> (busy). <br /><br /> Accepted values:<br /> <span class="markup-t3">TRANSPARENT</span> or <span class="markup-t3">OPAQUE</span>. </div> </div> </div> </div> </div> </div> <!-- Intercom --> <script> window.intercomSettings = { api_base: 'https://api-iam.intercom.io', app_id: 'r436mj2l', }; </script> <script> (function(){var w=window;var ic=w.Intercom;if(typeof ic==="function"){ic('reattach_activator');ic('update',w.intercomSettings);}else{var d=document;var i=function(){i.c(arguments);};i.q=[];i.c=function(args){i.q.push(args);};w.Intercom=i;var l=function(){var s=d.createElement('script');s.type='text/javascript';s.async=true;s.src='https://widget.intercom.io/widget/r436mj2l';var x=d.getElementsByTagName('script')[0];x.parentNode.insertBefore(s,x);};if(document.readyState==='complete'){l();}else if(w.attachEvent){w.attachEvent('onload',l);}else{w.addEventListener('load',l,false);}}})(); </script> <footer class="footer lazyelm"> <div class="ft-cnt"> <div class="s1"> <div class="k-main"> <a href="/" title="Home"> <img src="https://cdn.addevent.com/web/images/logo2.svg" width="40" height="40" alt="Home" loading="lazy" /> </a> <h5> Carefully crafted by your friends at <br /> © 2024 AddEvent Inc </h5> <!-- <Header Country: > <Server Country: > --> <div class="social"> <ul> <li><a href="https://www.facebook.com/addeventinc/" title="Facebook" class="facebook" target="_blank"><span>Facebook</span></a></li> <li><a href="https://twitter.com/AddEvent_Inc" title="Twitter" class="twitter" target="_blank"><span>Twitter</span></a></li> <li><a href="https://www.linkedin.com/company/25076591" title="LinkedIn" class="linkedin" target="_blank"><span>LinkedIn</span></a></li> <li><a href="https://www.instagram.com/addevent_inc" title="Instagram" class="instagram" target="_blank"><span>Instagram</span></a></li> <li><a href="https://www.youtube.com/channel/UC0qbG6tqVzcOBIxPYl8fo4g" title="YouTube" class="youtube" target="_blank"><span>YouTube</span></a></li> <li><a href="https://github.com/AddEventinc" title="Github" class="github" target="_blank"><span>Github</span></a></li> </ul> </div> </div> <div class="menu"> <div class="k1 k1-m3"> <p>Solutions</p> <ul class="mnu-ft"> <li><a href="/solutions/share-events" title="Share events">Share events</a></li> <li><a href="/solutions/collect-rsvp-events" title="Collect RSVPs">Collect RSVPs</a></li> <li><a href="/solutions/subscription-calendars" title="Subscription calendars">Subscription calendars</a></li> <li><a href="/solutions/embeddable-calendar" title="Embeddable calendars">Embeddable calendar</a></li> <li><a href="/solutions/automated-events" title="Automated events">Automated events</a></li> <li><a href="/solutions/analytics" title="Analytics">Analytics</a></li> </ul> </div> <div class="k1 k1-m2"> <p>Resources</p> <ul class="mnu-ft"> <li><a href="https://help.addevent.com" title="Help Center" target="_blank">Help Center</a></li> <li><a href="/c/documentation" title="Documentation">Documentation</a></li> <li><a href="/blog" title="Blog">Blog</a></li> <li><a href="/integrations" title="Integrations">Integrations</a></li> <li><a href="https://help.addevent.com/changelog" title="Updates" target="_blank">Updates</a></li> <li><a href="/c/contact" title="Contact">Contact</a></li> </ul> </div> <div class="k1 k1-m1"> <p>Company</p> <ul class="mnu-ft"> <li><a href="/c/about" title="About Us">About Us</a></li> <li><a href="https://jobs.addevent.com" title="Jobs" target="_blank">Jobs</a></li> <li><a href="/c/plans-and-pricing" title="Plans and pricing">Pricing</a></li> <li><a href="/c/legal/terms" title="Legal">Legal</a></li> <li><a href="https://pages.addevent.com/affiliate" title="Affiliate">Affiliate</a></li> </ul> </div> </div> </div> </div> </footer> <!-- User information for internal tracking --> <div id="account-guid" data-uid=""></div> </div> <!-- Javascript (changed 06/20/2024) --> <script src="https://cdn.addevent.com/web/js/jquery-3.6.1.min.js"></script> <script src="https://cdn.addevent.com/web/js/jquery-ui-1.13.2.min.js"></script> <script type="text/javascript" src="https://cdn.addevent.com/web/scripts/build/js/script.bundle.1727971720.js"></script> </body> </html>