Skip to contentSkip to navigationSkip to topbar
Twilio SendGrid Docs
Rate this page:
On this page

Timezone

(warning)

This documentation is for the SendGrid Web API v2

To access all the latest features and upcoming developments, please see our v3 API.

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


_10
{
_10
"name": "Eastern Time, US & Canada",
_10
"offset": 18000,
_10
"timezone": "America/New_York",
_10
"display": "GMT-05:00"
_10
}

Edit

edit page anchor

Update the timezone assigned to the user.

URI ParameterRequiredRequirementsDescription
timezoneYesIANA timezone Area/Location format(link takes you to an external page)Timezone to set on user
JSONXML

Call

call-3 page anchor
POSThttps://api.sendgrid.com/api/timezone/edit.json
POST Dataapi_user=apikey&api_key=your_sendgrid_api_key&timezone=America/New_York

Response

response-3 page anchor

_10
{
_10
"message": "success"
_10
}

List

list page anchor

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

Call

call-5 page anchor
GEThttps://api.sendgrid.com/api/timezone/list.json
GET Dataapi_user=apikey&api_key=your_sendgrid_api_key

Response

response-5 page anchor

_554
[
_554
{
_554
"timezone": "Pacific/Tongatapu",
_554
"offset": -46800,
_554
"display": "GMT+13:00",
_554
"name": "Nuku'alofa"
_554
},
_554
{
_554
"timezone": "Pacific/Auckland",
_554
"offset": -46800,
_554
"display": "GMT+12:00",
_554
"name": "Auckland, Wellington"
_554
},
_554
{
_554
"timezone": "Etc/GMT-12",
_554
"offset": -43200,
_554
"display": "GMT+12:00",
_554
"name": "Fiji, Kamchatka, Marshall Is."
_554
},
_554
{
_554
"timezone": "Asia/Magadan",
_554
"offset": -43200,
_554
"display": "GMT+12:00",
_554
"name": "Magadan"
_554
},
_554
{
_554
"timezone": "Etc/GMT-11",
_554
"offset": -39600,
_554
"display": "GMT+11:00",
_554
"name": "Solomon Is., New Caledonia"
_554
},
_554
{
_554
"timezone": "Asia/Vladivostok",
_554
"offset": -39600,
_554
"display": "GMT+11:00",
_554
"name": "Vladivostok"
_554
},
_554
{
_554
"timezone": "Asia/Yakutsk",
_554
"offset": -36000,
_554
"display": "GMT+10:00",
_554
"name": "Yakutsk"
_554
},
_554
{
_554
"timezone": "Australia/Brisbane",
_554
"offset": -36000,
_554
"display": "GMT+10:00",
_554
"name": "Brisbane"
_554
},
_554
{
_554
"timezone": "Australia/Sydney",
_554
"offset": -39600,
_554
"display": "GMT+10:00",
_554
"name": "Canberra, Melbourne, Sydney"
_554
},
_554
{
_554
"timezone": "Australia/Hobart",
_554
"offset": -39600,
_554
"display": "GMT+10:00",
_554
"name": "Hobart"
_554
},
_554
{
_554
"timezone": "Australia/Adelaide",
_554
"offset": -37800,
_554
"display": "GMT+09:30",
_554
"name": "Adelaide"
_554
},
_554
{
_554
"timezone": "Australia/Darwin",
_554
"offset": -34200,
_554
"display": "GMT+09:30",
_554
"name": "Darwin"
_554
},
_554
{
_554
"timezone": "Asia/Irkutsk",
_554
"offset": -32400,
_554
"display": "GMT+09:00",
_554
"name": "Irkutsk, Ulaan Bataar"
_554
},
_554
{
_554
"timezone": "Asia/Tokyo",
_554
"offset": -32400,
_554
"display": "GMT+09:00",
_554
"name": "Osaka, Sapporo, Tokyo"
_554
},
_554
{
_554
"timezone": "Asia/Seoul",
_554
"offset": -32400,
_554
"display": "GMT+09:00",
_554
"name": "Seoul"
_554
},
_554
{
_554
"timezone": "Asia/Hong_Kong",
_554
"offset": -28800,
_554
"display": "GMT+08:00",
_554
"name": "Beijing, Chongqing, Hong Kong, Urumqi"
_554
},
_554
{
_554
"timezone": "Asia/Krasnoyarsk",
_554
"offset": -28800,
_554
"display": "GMT+08:00",
_554
"name": "Krasnoyarsk"
_554
},
_554
{
_554
"timezone": "Australia/Perth",
_554
"offset": -28800,
_554
"display": "GMT+08:00",
_554
"name": "Perth"
_554
},
_554
{
_554
"timezone": "Asia/Taipei",
_554
"offset": -28800,
_554
"display": "GMT+08:00",
_554
"name": "Taipei"
_554
},
_554
{
_554
"timezone": "Asia/Bangkok",
_554
"offset": -25200,
_554
"display": "GMT+07:00",
_554
"name": "Bangkok, Hanoi, Jakarta"
_554
},
_554
{
_554
"timezone": "Asia/Novosibirsk",
_554
"offset": -25200,
_554
"display": "GMT+07:00",
_554
"name": "Novosibirsk"
_554
},
_554
{
_554
"timezone": "Asia/Rangoon",
_554
"offset": -23400,
_554
"display": "GMT+06:30",
_554
"name": "Yangon Rangoon"
_554
},
_554
{
_554
"timezone": "Asia/Dhaka",
_554
"offset": -21600,
_554
"display": "GMT+06:00",
_554
"name": "Astana, Dhaka"
_554
},
_554
{
_554
"timezone": "Asia/Yekaterinburg",
_554
"offset": -21600,
_554
"display": "GMT+06:00",
_554
"name": "Ekaterinburg"
_554
},
_554
{
_554
"timezone": "Asia/Katmandu",
_554
"offset": -20700,
_554
"display": "GMT+05:45",
_554
"name": "Kathmandu"
_554
},
_554
{
_554
"timezone": "Asia/Kolkata",
_554
"offset": -19800,
_554
"display": "GMT+05:30",
_554
"name": "Chennai, Kolkata, Mumbai, New Delhi"
_554
},
_554
{
_554
"timezone": "Asia/Tashkent",
_554
"offset": -18000,
_554
"display": "GMT+05:00",
_554
"name": "Asia/Tashkent"
_554
},
_554
{
_554
"timezone": "Asia/Kabul",
_554
"offset": -16200,
_554
"display": "GMT+04:30",
_554
"name": "Kabul"
_554
},
_554
{
_554
"timezone": "Asia/Dubai",
_554
"offset": -14400,
_554
"display": "GMT+04:00",
_554
"name": "Abu Dhabi, Muscat"
_554
},
_554
{
_554
"timezone": "Asia/Baku",
_554
"offset": -14400,
_554
"display": "GMT+04:00",
_554
"name": "Baku"
_554
},
_554
{
_554
"timezone": "Europe/Moscow",
_554
"offset": -14400,
_554
"display": "GMT+04:00",
_554
"name": "Moscow, St. Petersburg, Volgograd"
_554
},
_554
{
_554
"timezone": "Asia/Tbilisi",
_554
"offset": -14400,
_554
"display": "GMT+04:00",
_554
"name": "Tbilisi"
_554
},
_554
{
_554
"timezone": "Asia/Yerevan",
_554
"offset": -14400,
_554
"display": "GMT+04:00",
_554
"name": "Yerevan"
_554
},
_554
{
_554
"timezone": "Asia/Tehran",
_554
"offset": -12600,
_554
"display": "GMT+03:30",
_554
"name": "Tehran"
_554
},
_554
{
_554
"timezone": "Asia/Baghdad",
_554
"offset": -10800,
_554
"display": "GMT+03:00",
_554
"name": "Baghdad"
_554
},
_554
{
_554
"timezone": "Europe/Minsk",
_554
"offset": -10800,
_554
"display": "GMT+03:00",
_554
"name": "Kaliningrad, Minsk"
_554
},
_554
{
_554
"timezone": "Asia/Kuwait",
_554
"offset": -10800,
_554
"display": "GMT+03:00",
_554
"name": "Kuwait, Riyadh"
_554
},
_554
{
_554
"timezone": "Africa/Addis_Ababa",
_554
"offset": -10800,
_554
"display": "GMT+03:00",
_554
"name": "Nairobi"
_554
},
_554
{
_554
"timezone": "Asia/Amman",
_554
"offset": -7200,
_554
"display": "GMT+02:00",
_554
"name": "Amman"
_554
},
_554
{
_554
"timezone": "Europe/Bucharest",
_554
"offset": -7200,
_554
"display": "GMT+02:00",
_554
"name": "Athens, Bucharest"
_554
},
_554
{
_554
"timezone": "Asia/Beirut",
_554
"offset": -7200,
_554
"display": "GMT+02:00",
_554
"name": "Beirut"
_554
},
_554
{
_554
"timezone": "Africa/Cairo",
_554
"offset": -7200,
_554
"display": "GMT+02:00",
_554
"name": "Cairo"
_554
},
_554
{
_554
"timezone": "Asia/Damascus",
_554
"offset": -7200,
_554
"display": "GMT+02:00",
_554
"name": "Damascus"
_554
},
_554
{
_554
"timezone": "Africa/Blantyre",
_554
"offset": -7200,
_554
"display": "GMT+02:00",
_554
"name": "Harare, Pretoria"
_554
},
_554
{
_554
"timezone": "Europe/Helsinki",
_554
"offset": -7200,
_554
"display": "GMT+02:00",
_554
"name": "Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilnius"
_554
},
_554
{
_554
"timezone": "Europe/Istanbul",
_554
"offset": -7200,
_554
"display": "GMT+02:00",
_554
"name": "Istanbul"
_554
},
_554
{
_554
"timezone": "Asia/Jerusalem",
_554
"offset": -7200,
_554
"display": "GMT+02:00",
_554
"name": "Jerusalem"
_554
},
_554
{
_554
"timezone": "Europe/Nicosia",
_554
"offset": -7200,
_554
"display": "GMT+02:00",
_554
"name": "Nicosia"
_554
},
_554
{
_554
"timezone": "Europe/Amsterdam",
_554
"offset": -3600,
_554
"display": "GMT+01:00",
_554
"name": "Amsterdam, Berlin, Bern, Rome, Stockholm, Vienna"
_554
},
_554
{
_554
"timezone": "Europe/Belgrade",
_554
"offset": -3600,
_554
"display": "GMT+01:00",
_554
"name": "Belgrade, Bratislava, Budapest, Prague, Ljubljana"
_554
},
_554
{
_554
"timezone": "Europe/Brussels",
_554
"offset": -3600,
_554
"display": "GMT+01:00",
_554
"name": "Brussels, Copenhagen, Madrid, Paris"
_554
},
_554
{
_554
"timezone": "Europe/Warsaw",
_554
"offset": -3600,
_554
"display": "GMT+01:00",
_554
"name": "Sarajevo, Skopje, Warsaw, Zagreb"
_554
},
_554
{
_554
"timezone": "Africa/Algiers",
_554
"offset": -3600,
_554
"display": "GMT+01:00",
_554
"name": "West Central Africa"
_554
},
_554
{
_554
"timezone": "Africa/Windhoek",
_554
"offset": -7200,
_554
"display": "GMT+01:00",
_554
"name": "Windhoek"
_554
},
_554
{
_554
"timezone": "Africa/Casablanca",
_554
"offset": 0,
_554
"display": "GMT-00:00",
_554
"name": "Casablanca"
_554
},
_554
{
_554
"timezone": "Etc/UTC",
_554
"offset": 0,
_554
"display": "GMT-00:00",
_554
"name": "Coordinated Universal Time"
_554
},
_554
{
_554
"timezone": "Africa/Abidjan",
_554
"offset": 0,
_554
"display": "GMT-00:00",
_554
"name": "Monrovia, Reykjavik"
_554
},
_554
{
_554
"timezone": "Europe/London",
_554
"offset": 0,
_554
"display": "GMT-00:00",
_554
"name": "Dublin, Lisabon, London, Edinburgh"
_554
},
_554
{
_554
"timezone": "Atlantic/Cape_Verde",
_554
"offset": 3600,
_554
"display": "GMT-01:00",
_554
"name": "Cape Verde Is."
_554
},
_554
{
_554
"timezone": "Atlantic/Azores",
_554
"offset": 3600,
_554
"display": "GMT-01:00",
_554
"name": "Azores"
_554
},
_554
{
_554
"timezone": "America/Noronha",
_554
"offset": 7200,
_554
"display": "GMT-02:00",
_554
"name": "Mid-Atlantic"
_554
},
_554
{
_554
"timezone": "Etc/GMT+2",
_554
"offset": 7200,
_554
"display": "GMT-02:00",
_554
"name": "Coordinated Universal Time - 02"
_554
},
_554
{
_554
"timezone": "America/Sao_Paulo",
_554
"offset": 7200,
_554
"display": "GMT-03:00",
_554
"name": "Brasilia"
_554
},
_554
{
_554
"timezone": "America/Argentina/Buenos_Aires",
_554
"offset": 10800,
_554
"display": "GMT-03:00",
_554
"name": "Buenos Aires"
_554
},
_554
{
_554
"timezone": "America/Cayenne",
_554
"offset": 10800,
_554
"display": "GMT-03:00",
_554
"name": "Cayenne, Fortalenza"
_554
},
_554
{
_554
"timezone": "America/Godthab",
_554
"offset": 10800,
_554
"display": "GMT-03:00",
_554
"name": "Greenland"
_554
},
_554
{
_554
"timezone": "America/Montevideo",
_554
"offset": 7200,
_554
"display": "GMT-03:00",
_554
"name": "Montevideo"
_554
},
_554
{
_554
"timezone": "America/St_Johns",
_554
"offset": 12600,
_554
"display": "GMT-03:30",
_554
"name": "Newfoundland"
_554
},
_554
{
_554
"timezone": "America/Asuncion",
_554
"offset": 10800,
_554
"display": "GMT-04:00",
_554
"name": "Asuncion"
_554
},
_554
{
_554
"timezone": "America/Goose_Bay",
_554
"offset": 14400,
_554
"display": "GMT-04:00",
_554
"name": "Atlantic Time, Goose Bay"
_554
},
_554
{
_554
"timezone": "America/Glace_Bay",
_554
"offset": 14400,
_554
"display": "GMT-04:00",
_554
"name": "Atlantic Time, Canada"
_554
},
_554
{
_554
"timezone": "America/Cuiaba",
_554
"offset": 10800,
_554
"display": "GMT-04:00",
_554
"name": "Cuiaba"
_554
},
_554
{
_554
"timezone": "America/La_Paz",
_554
"offset": 14400,
_554
"display": "GMT-04:00",
_554
"name": "Georgetown, La Paz, Manaus, San Juan"
_554
},
_554
{
_554
"timezone": "America/Santiago",
_554
"offset": 10800,
_554
"display": "GMT-04:00",
_554
"name": "Santiago"
_554
},
_554
{
_554
"timezone": "America/Caracas",
_554
"offset": 16200,
_554
"display": "GMT-04:30",
_554
"name": "Caracas"
_554
},
_554
{
_554
"timezone": "America/Bogota",
_554
"offset": 18000,
_554
"display": "GMT-05:00",
_554
"name": "Bogota, Lima, Quito, Rio Branco"
_554
},
_554
{
_554
"timezone": "America/New_York",
_554
"offset": 18000,
_554
"display": "GMT-05:00",
_554
"name": "Eastern Time, US & Canada"
_554
},
_554
{
_554
"timezone": "America/Havana",
_554
"offset": 18000,
_554
"display": "GMT-05:00",
_554
"name": "Cuba"
_554
},
_554
{
_554
"timezone": "America/Indiana/Indianapolis",
_554
"offset": 18000,
_554
"display": "GMT-05:00",
_554
"name": "Indiana (East)"
_554
},
_554
{
_554
"timezone": "America/Belize",
_554
"offset": 21600,
_554
"display": "GMT-06:00",
_554
"name": "Central America"
_554
},
_554
{
_554
"timezone": "America/Chicago",
_554
"offset": 21600,
_554
"display": "GMT-06:00",
_554
"name": "Central Time, US & Canada"
_554
},
_554
{
_554
"timezone": "America/Cancun",
_554
"offset": 21600,
_554
"display": "GMT-06:00",
_554
"name": "Guadalajara, Mexico City, Monterrey"
_554
},
_554
{
_554
"timezone": "Canada/Saskatchewan",
_554
"offset": 21600,
_554
"display": "GMT-06:00",
_554
"name": "Saskatchewan"
_554
},
_554
{
_554
"timezone": "America/Dawson_Creek",
_554
"offset": 25200,
_554
"display": "GMT-07:00",
_554
"name": "Arizona"
_554
},
_554
{
_554
"timezone": "America/Chihuahua",
_554
"offset": 25200,
_554
"display": "GMT-07:00",
_554
"name": "Chihuahua, La Paz, Mazatlan"
_554
},
_554
{
_554
"timezone": "America/Denver",
_554
"offset": 25200,
_554
"display": "GMT-07:00",
_554
"name": "Mountain Time, US & Canada"
_554
},
_554
{
_554
"timezone": "America/Ensenada",
_554
"offset": 28800,
_554
"display": "GMT-08:00",
_554
"name": "Tijuana, Baja California"
_554
},
_554
{
_554
"timezone": "America/Los_Angeles",
_554
"offset": 28800,
_554
"display": "GMT-08:00",
_554
"name": "Pacific Time, US & Canada"
_554
},
_554
{
_554
"timezone": "America/Anchorage",
_554
"offset": 32400,
_554
"display": "GMT-09:00",
_554
"name": "Alaska"
_554
},
_554
{
_554
"timezone": "Etc/GMT+10",
_554
"offset": 36000,
_554
"display": "GMT-10:00",
_554
"name": "Hawaii"
_554
},
_554
{
_554
"timezone": "Pacific/Midway",
_554
"offset": 39600,
_554
"display": "GMT-11:00",
_554
"name": "Midway Island, Samoa"
_554
},
_554
{
_554
"timezone": "Etc/GMT+12",
_554
"offset": 43200,
_554
"display": "GMT-12:00",
_554
"name": "International Date Line West"
_554
}
_554
]

Rate this page: