Skip to contentSkip to navigationSkip to topbar
On this page

Timezone


(warning)

This documentation is for the SendGrid Web API v2

We will deprecate this version on February 10, 2025. To access all the latest features and upcoming developments, please see our v3 API. For assistance with transitioning, refer to our migration guide.

A user's timezone affects the displayed dates on all Suppression Lists and Statistics.


Get

get page anchor

Get current timezone assigned to the user.

JSONXML

Call

GEThttps://api.sendgrid.com/api/timezone/get.json
GET Dataapi_user=apikey&api_key=your_sendgrid_api_key

Response

1
{
2
"name": "Eastern Time, US & Canada",
3
"offset": 18000,
4
"timezone": "America/New_York",
5
"display": "GMT-05:00"
6
}


Update the timezone assigned to the user.

JSONXML
POSThttps://api.sendgrid.com/api/timezone/edit.json
POST Dataapi_user=apikey&api_key=your_sendgrid_api_key&timezone=America/New_York
1
{
2
"message": "success"
3
}


This example provides the full list of IANA timezones in the SendGrid system, for reference. It's best practice to use the timezone parameter.

URI ParameterRequiredRequirementsDescription
timezoneNoIANA timezone Area/Location format(link takes you to an external page)Restrict query to confirm existence of named timezone
JSONXML
GEThttps://api.sendgrid.com/api/timezone/list.json
GET Dataapi_user=apikey&api_key=your_sendgrid_api_key
1
[
2
{
3
"timezone": "Pacific/Tongatapu",
4
"offset": -46800,
5
"display": "GMT+13:00",
6
"name": "Nuku'alofa"
7
},
8
{
9
"timezone": "Pacific/Auckland",
10
"offset": -46800,
11
"display": "GMT+12:00",
12
"name": "Auckland, Wellington"
13
},
14
{
15
"timezone": "Etc/GMT-12",
16
"offset": -43200,
17
"display": "GMT+12:00",
18
"name": "Fiji, Kamchatka, Marshall Is."
19
},
20
{
21
"timezone": "Asia/Magadan",
22
"offset": -43200,
23
"display": "GMT+12:00",
24
"name": "Magadan"
25
},
26
{
27
"timezone": "Etc/GMT-11",
28
"offset": -39600,
29
"display": "GMT+11:00",
30
"name": "Solomon Is., New Caledonia"
31
},
32
{
33
"timezone": "Asia/Vladivostok",
34
"offset": -39600,
35
"display": "GMT+11:00",
36
"name": "Vladivostok"
37
},
38
{
39
"timezone": "Asia/Yakutsk",
40
"offset": -36000,
41
"display": "GMT+10:00",
42
"name": "Yakutsk"
43
},
44
{
45
"timezone": "Australia/Brisbane",
46
"offset": -36000,
47
"display": "GMT+10:00",
48
"name": "Brisbane"
49
},
50
{
51
"timezone": "Australia/Sydney",
52
"offset": -39600,
53
"display": "GMT+10:00",
54
"name": "Canberra, Melbourne, Sydney"
55
},
56
{
57
"timezone": "Australia/Hobart",
58
"offset": -39600,
59
"display": "GMT+10:00",
60
"name": "Hobart"
61
},
62
{
63
"timezone": "Australia/Adelaide",
64
"offset": -37800,
65
"display": "GMT+09:30",
66
"name": "Adelaide"
67
},
68
{
69
"timezone": "Australia/Darwin",
70
"offset": -34200,
71
"display": "GMT+09:30",
72
"name": "Darwin"
73
},
74
{
75
"timezone": "Asia/Irkutsk",
76
"offset": -32400,
77
"display": "GMT+09:00",
78
"name": "Irkutsk, Ulaan Bataar"
79
},
80
{
81
"timezone": "Asia/Tokyo",
82
"offset": -32400,
83
"display": "GMT+09:00",
84
"name": "Osaka, Sapporo, Tokyo"
85
},
86
{
87
"timezone": "Asia/Seoul",
88
"offset": -32400,
89
"display": "GMT+09:00",
90
"name": "Seoul"
91
},
92
{
93
"timezone": "Asia/Hong_Kong",
94
"offset": -28800,
95
"display": "GMT+08:00",
96
"name": "Beijing, Chongqing, Hong Kong, Urumqi"
97
},
98
{
99
"timezone": "Asia/Krasnoyarsk",
100
"offset": -28800,
101
"display": "GMT+08:00",
102
"name": "Krasnoyarsk"
103
},
104
{
105
"timezone": "Australia/Perth",
106
"offset": -28800,
107
"display": "GMT+08:00",
108
"name": "Perth"
109
},
110
{
111
"timezone": "Asia/Taipei",
112
"offset": -28800,
113
"display": "GMT+08:00",
114
"name": "Taipei"
115
},
116
{
117
"timezone": "Asia/Bangkok",
118
"offset": -25200,
119
"display": "GMT+07:00",
120
"name": "Bangkok, Hanoi, Jakarta"
121
},
122
{
123
"timezone": "Asia/Novosibirsk",
124
"offset": -25200,
125
"display": "GMT+07:00",
126
"name": "Novosibirsk"
127
},
128
{
129
"timezone": "Asia/Rangoon",
130
"offset": -23400,
131
"display": "GMT+06:30",
132
"name": "Yangon Rangoon"
133
},
134
{
135
"timezone": "Asia/Dhaka",
136
"offset": -21600,
137
"display": "GMT+06:00",
138
"name": "Astana, Dhaka"
139
},
140
{
141
"timezone": "Asia/Yekaterinburg",
142
"offset": -21600,
143
"display": "GMT+06:00",
144
"name": "Ekaterinburg"
145
},
146
{
147
"timezone": "Asia/Katmandu",
148
"offset": -20700,
149
"display": "GMT+05:45",
150
"name": "Kathmandu"
151
},
152
{
153
"timezone": "Asia/Kolkata",
154
"offset": -19800,
155
"display": "GMT+05:30",
156
"name": "Chennai, Kolkata, Mumbai, New Delhi"
157
},
158
{
159
"timezone": "Asia/Tashkent",
160
"offset": -18000,
161
"display": "GMT+05:00",
162
"name": "Asia/Tashkent"
163
},
164
{
165
"timezone": "Asia/Kabul",
166
"offset": -16200,
167
"display": "GMT+04:30",
168
"name": "Kabul"
169
},
170
{
171
"timezone": "Asia/Dubai",
172
"offset": -14400,
173
"display": "GMT+04:00",
174
"name": "Abu Dhabi, Muscat"
175
},
176
{
177
"timezone": "Asia/Baku",
178
"offset": -14400,
179
"display": "GMT+04:00",
180
"name": "Baku"
181
},
182
{
183
"timezone": "Europe/Moscow",
184
"offset": -14400,
185
"display": "GMT+04:00",
186
"name": "Moscow, St. Petersburg, Volgograd"
187
},
188
{
189
"timezone": "Asia/Tbilisi",
190
"offset": -14400,
191
"display": "GMT+04:00",
192
"name": "Tbilisi"
193
},
194
{
195
"timezone": "Asia/Yerevan",
196
"offset": -14400,
197
"display": "GMT+04:00",
198
"name": "Yerevan"
199
},
200
{
201
"timezone": "Asia/Tehran",
202
"offset": -12600,
203
"display": "GMT+03:30",
204
"name": "Tehran"
205
},
206
{
207
"timezone": "Asia/Baghdad",
208
"offset": -10800,
209
"display": "GMT+03:00",
210
"name": "Baghdad"
211
},
212
{
213
"timezone": "Europe/Minsk",
214
"offset": -10800,
215
"display": "GMT+03:00",
216
"name": "Kaliningrad, Minsk"
217
},
218
{
219
"timezone": "Asia/Kuwait",
220
"offset": -10800,
221
"display": "GMT+03:00",
222
"name": "Kuwait, Riyadh"
223
},
224
{
225
"timezone": "Africa/Addis_Ababa",
226
"offset": -10800,
227
"display": "GMT+03:00",
228
"name": "Nairobi"
229
},
230
{
231
"timezone": "Asia/Amman",
232
"offset": -7200,
233
"display": "GMT+02:00",
234
"name": "Amman"
235
},
236
{
237
"timezone": "Europe/Bucharest",
238
"offset": -7200,
239
"display": "GMT+02:00",
240
"name": "Athens, Bucharest"
241
},
242
{
243
"timezone": "Asia/Beirut",
244
"offset": -7200,
245
"display": "GMT+02:00",
246
"name": "Beirut"
247
},
248
{
249
"timezone": "Africa/Cairo",
250
"offset": -7200,
251
"display": "GMT+02:00",
252
"name": "Cairo"
253
},
254
{
255
"timezone": "Asia/Damascus",
256
"offset": -7200,
257
"display": "GMT+02:00",
258
"name": "Damascus"
259
},
260
{
261
"timezone": "Africa/Blantyre",
262
"offset": -7200,
263
"display": "GMT+02:00",
264
"name": "Harare, Pretoria"
265
},
266
{
267
"timezone": "Europe/Helsinki",
268
"offset": -7200,
269
"display": "GMT+02:00",
270
"name": "Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilnius"
271
},
272
{
273
"timezone": "Europe/Istanbul",
274
"offset": -7200,
275
"display": "GMT+02:00",
276
"name": "Istanbul"
277
},
278
{
279
"timezone": "Asia/Jerusalem",
280
"offset": -7200,
281
"display": "GMT+02:00",
282
"name": "Jerusalem"
283
},
284
{
285
"timezone": "Europe/Nicosia",
286
"offset": -7200,
287
"display": "GMT+02:00",
288
"name": "Nicosia"
289
},
290
{
291
"timezone": "Europe/Amsterdam",
292
"offset": -3600,
293
"display": "GMT+01:00",
294
"name": "Amsterdam, Berlin, Bern, Rome, Stockholm, Vienna"
295
},
296
{
297
"timezone": "Europe/Belgrade",
298
"offset": -3600,
299
"display": "GMT+01:00",
300
"name": "Belgrade, Bratislava, Budapest, Prague, Ljubljana"
301
},
302
{
303
"timezone": "Europe/Brussels",
304
"offset": -3600,
305
"display": "GMT+01:00",
306
"name": "Brussels, Copenhagen, Madrid, Paris"
307
},
308
{
309
"timezone": "Europe/Warsaw",
310
"offset": -3600,
311
"display": "GMT+01:00",
312
"name": "Sarajevo, Skopje, Warsaw, Zagreb"
313
},
314
{
315
"timezone": "Africa/Algiers",
316
"offset": -3600,
317
"display": "GMT+01:00",
318
"name": "West Central Africa"
319
},
320
{
321
"timezone": "Africa/Windhoek",
322
"offset": -7200,
323
"display": "GMT+01:00",
324
"name": "Windhoek"
325
},
326
{
327
"timezone": "Africa/Casablanca",
328
"offset": 0,
329
"display": "GMT-00:00",
330
"name": "Casablanca"
331
},
332
{
333
"timezone": "Etc/UTC",
334
"offset": 0,
335
"display": "GMT-00:00",
336
"name": "Coordinated Universal Time"
337
},
338
{
339
"timezone": "Africa/Abidjan",
340
"offset": 0,
341
"display": "GMT-00:00",
342
"name": "Monrovia, Reykjavik"
343
},
344
{
345
"timezone": "Europe/London",
346
"offset": 0,
347
"display": "GMT-00:00",
348
"name": "Dublin, Lisabon, London, Edinburgh"
349
},
350
{
351
"timezone": "Atlantic/Cape_Verde",
352
"offset": 3600,
353
"display": "GMT-01:00",
354
"name": "Cape Verde Is."
355
},
356
{
357
"timezone": "Atlantic/Azores",
358
"offset": 3600,
359
"display": "GMT-01:00",
360
"name": "Azores"
361
},
362
{
363
"timezone": "America/Noronha",
364
"offset": 7200,
365
"display": "GMT-02:00",
366
"name": "Mid-Atlantic"
367
},
368
{
369
"timezone": "Etc/GMT+2",
370
"offset": 7200,
371
"display": "GMT-02:00",
372
"name": "Coordinated Universal Time - 02"
373
},
374
{
375
"timezone": "America/Sao_Paulo",
376
"offset": 7200,
377
"display": "GMT-03:00",
378
"name": "Brasilia"
379
},
380
{
381
"timezone": "America/Argentina/Buenos_Aires",
382
"offset": 10800,
383
"display": "GMT-03:00",
384
"name": "Buenos Aires"
385
},
386
{
387
"timezone": "America/Cayenne",
388
"offset": 10800,
389
"display": "GMT-03:00",
390
"name": "Cayenne, Fortalenza"
391
},
392
{
393
"timezone": "America/Godthab",
394
"offset": 10800,
395
"display": "GMT-03:00",
396
"name": "Greenland"
397
},
398
{
399
"timezone": "America/Montevideo",
400
"offset": 7200,
401
"display": "GMT-03:00",
402
"name": "Montevideo"
403
},
404
{
405
"timezone": "America/St_Johns",
406
"offset": 12600,
407
"display": "GMT-03:30",
408
"name": "Newfoundland"
409
},
410
{
411
"timezone": "America/Asuncion",
412
"offset": 10800,
413
"display": "GMT-04:00",
414
"name": "Asuncion"
415
},
416
{
417
"timezone": "America/Goose_Bay",
418
"offset": 14400,
419
"display": "GMT-04:00",
420
"name": "Atlantic Time, Goose Bay"
421
},
422
{
423
"timezone": "America/Glace_Bay",
424
"offset": 14400,
425
"display": "GMT-04:00",
426
"name": "Atlantic Time, Canada"
427
},
428
{
429
"timezone": "America/Cuiaba",
430
"offset": 10800,
431
"display": "GMT-04:00",
432
"name": "Cuiaba"
433
},
434
{
435
"timezone": "America/La_Paz",
436
"offset": 14400,
437
"display": "GMT-04:00",
438
"name": "Georgetown, La Paz, Manaus, San Juan"
439
},
440
{
441
"timezone": "America/Santiago",
442
"offset": 10800,
443
"display": "GMT-04:00",
444
"name": "Santiago"
445
},
446
{
447
"timezone": "America/Caracas",
448
"offset": 16200,
449
"display": "GMT-04:30",
450
"name": "Caracas"
451
},
452
{
453
"timezone": "America/Bogota",
454
"offset": 18000,
455
"display": "GMT-05:00",
456
"name": "Bogota, Lima, Quito, Rio Branco"
457
},
458
{
459
"timezone": "America/New_York",
460
"offset": 18000,
461
"display": "GMT-05:00",
462
"name": "Eastern Time, US & Canada"
463
},
464
{
465
"timezone": "America/Havana",
466
"offset": 18000,
467
"display": "GMT-05:00",
468
"name": "Cuba"
469
},
470
{
471
"timezone": "America/Indiana/Indianapolis",
472
"offset": 18000,
473
"display": "GMT-05:00",
474
"name": "Indiana (East)"
475
},
476
{
477
"timezone": "America/Belize",
478
"offset": 21600,
479
"display": "GMT-06:00",
480
"name": "Central America"
481
},
482
{
483
"timezone": "America/Chicago",
484
"offset": 21600,
485
"display": "GMT-06:00",
486
"name": "Central Time, US & Canada"
487
},
488
{
489
"timezone": "America/Cancun",
490
"offset": 21600,
491
"display": "GMT-06:00",
492
"name": "Guadalajara, Mexico City, Monterrey"
493
},
494
{
495
"timezone": "Canada/Saskatchewan",
496
"offset": 21600,
497
"display": "GMT-06:00",
498
"name": "Saskatchewan"
499
},
500
{
501
"timezone": "America/Dawson_Creek",
502
"offset": 25200,
503
"display": "GMT-07:00",
504
"name": "Arizona"
505
},
506
{
507
"timezone": "America/Chihuahua",
508
"offset": 25200,
509
"display": "GMT-07:00",
510
"name": "Chihuahua, La Paz, Mazatlan"
511
},
512
{
513
"timezone": "America/Denver",
514
"offset": 25200,
515
"display": "GMT-07:00",
516
"name": "Mountain Time, US & Canada"
517
},
518
{
519
"timezone": "America/Ensenada",
520
"offset": 28800,
521
"display": "GMT-08:00",
522
"name": "Tijuana, Baja California"
523
},
524
{
525
"timezone": "America/Los_Angeles",
526
"offset": 28800,
527
"display": "GMT-08:00",
528
"name": "Pacific Time, US & Canada"
529
},
530
{
531
"timezone": "America/Anchorage",
532
"offset": 32400,
533
"display": "GMT-09:00",
534
"name": "Alaska"
535
},
536
{
537
"timezone": "Etc/GMT+10",
538
"offset": 36000,
539
"display": "GMT-10:00",
540
"name": "Hawaii"
541
},
542
{
543
"timezone": "Pacific/Midway",
544
"offset": 39600,
545
"display": "GMT-11:00",
546
"name": "Midway Island, Samoa"
547
},
548
{
549
"timezone": "Etc/GMT+12",
550
"offset": 43200,
551
"display": "GMT-12:00",
552
"name": "International Date Line West"
553
}
554
]

Need some help?

Terms of service

Copyright © 2024 Twilio Inc.