Scheduling

Notification scheduling defaults

When you create a notification, you will be able to set timedelta, which may be used on its own as a delay (when having a positive value), or in combination with the schedule parameter set in the event payloads.

Event payload

The schedule option lets you fine tune when the event should be processed. Common use cases are meeting reminders, post-event surveys, a specific time of the day, a simple delay, etc.

Options

The options for scheduling are: datetime, timedelta, time and timezone. You may use multiple combinations of these but some combinations are not allowed (see below).

Definitions

  • datetime (ISO 8601 format): By default we compute when to process an event based on its creation date. If you set datetime, the event will be processed at the time specified.
    Example: 2022-01-23T22:22:00-07:00
    The timezone is optional and defaults to UTC.
  • timedelta (number + unit): Offsets the processing of an event up to 30 days in the past/future.
    Examples: +1day, -30minutes, 3600seconds
    Allowed units are: "week(s)", "day(s)", "hour(s)", "minute(s)", "second(s)"
    If no unit is set, the default is seconds, e.g. 2022-01-23T22:22:00
  • time (24 hour format): Ideally processes the event at a specific time of the day. If the event is sent after that time, it is processed immediately. So for a time set at 13:00, events sent from 00:00 to 13:00 will be processed at 13:00, and events sent from 13:01 to 23:59 will be sent immediately.
    Example: 10:00, 23:59:59
    If the timezone attribute isn't set, UTC is assumed.
  • timezone: Can only be used with time.
    Example: "America/Denver", "Europe/Paris"
Available timezones
Africa/AbidjanAmerica/MaceioAsia/Phnom_PenhEurope/Kiev
Africa/AccraAmerica/ManaguaAsia/PontianakEurope/Kirov
Africa/Addis_AbabaAmerica/ManausAsia/PyongyangEurope/Lisbon
Africa/AlgiersAmerica/MarigotAsia/QatarEurope/Ljubljana
Africa/AsmaraAmerica/MartiniqueAsia/QostanayEurope/London
Africa/AsmeraAmerica/MatamorosAsia/QyzylordaEurope/Luxembourg
Africa/BamakoAmerica/MazatlanAsia/RangoonEurope/Madrid
Africa/BanguiAmerica/MendozaAsia/RiyadhEurope/Malta
Africa/BanjulAmerica/MenomineeAsia/SaigonEurope/Mariehamn
Africa/BissauAmerica/MeridaAsia/SakhalinEurope/Minsk
Africa/BlantyreAmerica/MetlakatlaAsia/SamarkandEurope/Monaco
Africa/BrazzavilleAmerica/Mexico_CityAsia/SeoulEurope/Moscow
Africa/BujumburaAmerica/MiquelonAsia/ShanghaiEurope/Nicosia
Africa/CairoAmerica/MonctonAsia/SingaporeEurope/Oslo
Africa/CasablancaAmerica/MonterreyAsia/SrednekolymskEurope/Paris
Africa/CeutaAmerica/MontevideoAsia/TaipeiEurope/Podgorica
Africa/ConakryAmerica/MontrealAsia/TashkentEurope/Prague
Africa/DakarAmerica/MontserratAsia/TbilisiEurope/Riga
Africa/Dar_es_SalaamAmerica/NassauAsia/TehranEurope/Rome
Africa/DjiboutiAmerica/New_YorkAsia/Tel_AvivEurope/Samara
Africa/DoualaAmerica/NipigonAsia/ThimbuEurope/San_Marino
Africa/El_AaiunAmerica/NomeAsia/ThimphuEurope/Sarajevo
Africa/FreetownAmerica/NoronhaAsia/TokyoEurope/Saratov
Africa/GaboroneAmerica/North_Dakota/BeulahAsia/TomskEurope/Simferopol
Africa/HarareAmerica/North_Dakota/CenterAsia/Ujung_PandangEurope/Skopje
Africa/JohannesburgAmerica/North_Dakota/New_SalemAsia/UlaanbaatarEurope/Sofia
Africa/JubaAmerica/NuukAsia/Ulan_BatorEurope/Stockholm
Africa/KampalaAmerica/OjinagaAsia/UrumqiEurope/Tallinn
Africa/KhartoumAmerica/PanamaAsia/Ust-NeraEurope/Tirane
Africa/KigaliAmerica/PangnirtungAsia/VientianeEurope/Tiraspol
Africa/KinshasaAmerica/ParamariboAsia/VladivostokEurope/Ulyanovsk
Africa/LagosAmerica/PhoenixAsia/YakutskEurope/Uzhgorod
Africa/LibrevilleAmerica/Port-au-PrinceAsia/YangonEurope/Vaduz
Africa/LomeAmerica/Port_of_SpainAsia/YekaterinburgEurope/Vatican
Africa/LuandaAmerica/Porto_AcreAsia/YerevanEurope/Vienna
Africa/LubumbashiAmerica/Porto_VelhoAtlantic/AzoresEurope/Vilnius
Africa/LusakaAmerica/Puerto_RicoAtlantic/BermudaEurope/Volgograd
Africa/MalaboAmerica/Punta_ArenasAtlantic/CanaryEurope/Warsaw
Africa/MaputoAmerica/Rainy_RiverAtlantic/Cape_VerdeEurope/Zagreb
Africa/MaseruAmerica/Rankin_InletAtlantic/FaeroeEurope/Zaporozhye
Africa/MbabaneAmerica/RecifeAtlantic/FaroeEurope/Zurich
Africa/MogadishuAmerica/ReginaAtlantic/Jan_MayenFactory
Africa/MonroviaAmerica/ResoluteAtlantic/MadeiraGB
Africa/NairobiAmerica/Rio_BrancoAtlantic/ReykjavikGB-Eire
Africa/NdjamenaAmerica/RosarioAtlantic/South_GeorgiaGMT
Africa/NiameyAmerica/Santa_IsabelAtlantic/St_HelenaGMT+0
Africa/NouakchottAmerica/SantaremAtlantic/StanleyGMT-0
Africa/OuagadougouAmerica/SantiagoAustralia/ACTGMT0
Africa/Porto-NovoAmerica/Santo_DomingoAustralia/AdelaideGreenwich
Africa/Sao_TomeAmerica/Sao_PauloAustralia/BrisbaneHST
Africa/TimbuktuAmerica/ScoresbysundAustralia/Broken_HillHongkong
Africa/TripoliAmerica/ShiprockAustralia/CanberraIceland
Africa/TunisAmerica/SitkaAustralia/CurrieIndian/Antananarivo
Africa/WindhoekAmerica/St_BarthelemyAustralia/DarwinIndian/Chagos
America/AdakAmerica/St_JohnsAustralia/EuclaIndian/Christmas
America/AnchorageAmerica/St_KittsAustralia/HobartIndian/Cocos
America/AnguillaAmerica/St_LuciaAustralia/LHIIndian/Comoro
America/AntiguaAmerica/St_ThomasAustralia/LindemanIndian/Kerguelen
America/AraguainaAmerica/St_VincentAustralia/Lord_HoweIndian/Mahe
America/Argentina/Buenos_AiresAmerica/Swift_CurrentAustralia/MelbourneIndian/Maldives
America/Argentina/CatamarcaAmerica/TegucigalpaAustralia/NSWIndian/Mauritius
America/Argentina/ComodRivadaviaAmerica/ThuleAustralia/NorthIndian/Mayotte
America/Argentina/CordobaAmerica/Thunder_BayAustralia/PerthIndian/Reunion
America/Argentina/JujuyAmerica/TijuanaAustralia/QueenslandIran
America/Argentina/La_RiojaAmerica/TorontoAustralia/SouthIsrael
America/Argentina/MendozaAmerica/TortolaAustralia/SydneyJamaica
America/Argentina/Rio_GallegosAmerica/VancouverAustralia/TasmaniaJapan
America/Argentina/SaltaAmerica/VirginAustralia/VictoriaKwajalein
America/Argentina/San_JuanAmerica/WhitehorseAustralia/WestLibya
America/Argentina/San_LuisAmerica/WinnipegAustralia/YancowinnaMET
America/Argentina/TucumanAmerica/YakutatBrazil/AcreMST
America/Argentina/UshuaiaAmerica/YellowknifeBrazil/DeNoronhaMST7MDT
America/ArubaAntarctica/CaseyBrazil/EastMexico/BajaNorte
America/AsuncionAntarctica/DavisBrazil/WestMexico/BajaSur
America/AtikokanAntarctica/DumontDUrvilleCETMexico/General
America/AtkaAntarctica/MacquarieCST6CDTNZ
America/BahiaAntarctica/MawsonCanada/AtlanticNZ-CHAT
America/Bahia_BanderasAntarctica/McMurdoCanada/CentralNavajo
America/BarbadosAntarctica/PalmerCanada/EasternPRC
America/BelemAntarctica/RotheraCanada/MountainPST8PDT
America/BelizeAntarctica/South_PoleCanada/NewfoundlandPacific/Apia
America/Blanc-SablonAntarctica/SyowaCanada/PacificPacific/Auckland
America/Boa_VistaAntarctica/TrollCanada/SaskatchewanPacific/Bougainville
America/BogotaAntarctica/VostokCanada/YukonPacific/Chatham
America/BoiseArctic/LongyearbyenChile/ContinentalPacific/Chuuk
America/Buenos_AiresAsia/AdenChile/EasterIslandPacific/Easter
America/Cambridge_BayAsia/AlmatyCubaPacific/Efate
America/Campo_GrandeAsia/AmmanEETPacific/Enderbury
America/CancunAsia/AnadyrESTPacific/Fakaofo
America/CaracasAsia/AqtauEST5EDTPacific/Fiji
America/CatamarcaAsia/AqtobeEgyptPacific/Funafuti
America/CayenneAsia/AshgabatEirePacific/Galapagos
America/CaymanAsia/AshkhabadEtc/GMTPacific/Gambier
America/ChicagoAsia/AtyrauEtc/GMT+0Pacific/Guadalcanal
America/ChihuahuaAsia/BaghdadEtc/GMT+1Pacific/Guam
America/Coral_HarbourAsia/BahrainEtc/GMT+10Pacific/Honolulu
America/CordobaAsia/BakuEtc/GMT+11Pacific/Johnston
America/Costa_RicaAsia/BangkokEtc/GMT+12Pacific/Kanton
America/CrestonAsia/BarnaulEtc/GMT+2Pacific/Kiritimati
America/CuiabaAsia/BeirutEtc/GMT+3Pacific/Kosrae
America/CuracaoAsia/BishkekEtc/GMT+4Pacific/Kwajalein
America/DanmarkshavnAsia/BruneiEtc/GMT+5Pacific/Majuro
America/DawsonAsia/CalcuttaEtc/GMT+6Pacific/Marquesas
America/Dawson_CreekAsia/ChitaEtc/GMT+7Pacific/Midway
America/DenverAsia/ChoibalsanEtc/GMT+8Pacific/Nauru
America/DetroitAsia/ChongqingEtc/GMT+9Pacific/Niue
America/DominicaAsia/ChungkingEtc/GMT-0Pacific/Norfolk
America/EdmontonAsia/ColomboEtc/GMT-1Pacific/Noumea
America/EirunepeAsia/DaccaEtc/GMT-10Pacific/Pago_Pago
America/El_SalvadorAsia/DamascusEtc/GMT-11Pacific/Palau
America/EnsenadaAsia/DhakaEtc/GMT-12Pacific/Pitcairn
America/Fort_NelsonAsia/DiliEtc/GMT-13Pacific/Pohnpei
America/Fort_WayneAsia/DubaiEtc/GMT-14Pacific/Ponape
America/FortalezaAsia/DushanbeEtc/GMT-2Pacific/Port_Moresby
America/Glace_BayAsia/FamagustaEtc/GMT-3Pacific/Rarotonga
America/GodthabAsia/GazaEtc/GMT-4Pacific/Saipan
America/Goose_BayAsia/HarbinEtc/GMT-5Pacific/Samoa
America/Grand_TurkAsia/HebronEtc/GMT-6Pacific/Tahiti
America/GrenadaAsia/Ho_Chi_MinhEtc/GMT-7Pacific/Tarawa
America/GuadeloupeAsia/Hong_KongEtc/GMT-8Pacific/Tongatapu
America/GuatemalaAsia/HovdEtc/GMT-9Pacific/Truk
America/GuayaquilAsia/IrkutskEtc/GMT0Pacific/Wake
America/GuyanaAsia/IstanbulEtc/GreenwichPacific/Wallis
America/HalifaxAsia/JakartaEtc/UCTPacific/Yap
America/HavanaAsia/JayapuraEtc/UTCPoland
America/HermosilloAsia/JerusalemEtc/UniversalPortugal
America/Indiana/IndianapolisAsia/KabulEtc/ZuluROC
America/Indiana/KnoxAsia/KamchatkaEurope/AmsterdamROK
America/Indiana/MarengoAsia/KarachiEurope/AndorraSingapore
America/Indiana/PetersburgAsia/KashgarEurope/AstrakhanTurkey
America/Indiana/Tell_CityAsia/KathmanduEurope/AthensUCT
America/Indiana/VevayAsia/KatmanduEurope/BelfastUS/Alaska
America/Indiana/VincennesAsia/KhandygaEurope/BelgradeUS/Aleutian
America/Indiana/WinamacAsia/KolkataEurope/BerlinUS/Arizona
America/IndianapolisAsia/KrasnoyarskEurope/BratislavaUS/Central
America/InuvikAsia/Kuala_LumpurEurope/BrusselsUS/East-Indiana
America/IqaluitAsia/KuchingEurope/BucharestUS/Eastern
America/JamaicaAsia/KuwaitEurope/BudapestUS/Hawaii
America/JujuyAsia/MacaoEurope/BusingenUS/Indiana-Starke
America/JuneauAsia/MacauEurope/ChisinauUS/Michigan
America/Kentucky/LouisvilleAsia/MagadanEurope/CopenhagenUS/Mountain
America/Kentucky/MonticelloAsia/MakassarEurope/DublinUS/Pacific
America/Knox_INAsia/ManilaEurope/GibraltarUS/Samoa
America/KralendijkAsia/MuscatEurope/GuernseyUTC
America/La_PazAsia/NicosiaEurope/HelsinkiUniversal
America/LimaAsia/NovokuznetskEurope/Isle_of_ManW-SU
America/Los_AngelesAsia/NovosibirskEurope/IstanbulWET
America/LouisvilleAsia/OmskEurope/JerseyZulu
America/Lower_PrincesAsia/OralEurope/Kaliningrad

Combinations

  • datetime + timedelta: You can set a timedelta (negative or positive) to offset the processing of an event scheduled at a specific datetime.

    • Send reminder 30 minutes before the meeting:
      datetime="2022-01-23T22:22:00-07:00" timedelta="-30minutes"
    • Send a survey a day after an event:
      datetime="2022-01-23T22:22:00-07:00" timedelta="+1day"
  • time + timezone: Set a specific timezone for the time of the day.
    time="13:30" timezone="Europe/Paris"

  • datetime + time: Send at a specific time on a specific day.
    datetime="2022-01-02T13:00" time="11:30"


Did this page help you?