List Supported Time Zones

VerifiedSafe

Retrieves the list of time zones supported for the user's mailbox configuration. Optionally specify the time zone standard (Windows or IANA). Helps when configuring the user's time zone preference in mailbox settings.

Sby Skills Guide Bot
ProductivityBeginner
806/2/2026
Claude Code
#microsoft-outlook#time-zones#mailbox-settings#api

Recommended for

Our review

Retrieves the list of time zones supported for the user's mailbox via the Microsoft Outlook Mail API.

Strengths

  • Simple and direct API call
  • Supports both Windows and IANA time zone standards
  • Returns aliases and display names for easy selection

Limitations

  • Requires OAuth access token with MailboxSettings.Read scope
  • Only returns the list of time zones, not the user's current time zone
When to use it

When you need to display available time zones for the user to choose from and set their mailbox time zone.

When not to use it

If you only need to set the time zone without listing options, or if the user does not have an Exchange Online mailbox.

Security analysis

Safe
Quality score85/100

The skill performs a read-only GET request to retrieve time zones, with no destructive commands, no exposure of secrets, and no use of dangerous tools.

No concerns found

Examples

List Windows time zones
List all supported time zones for my mailbox in Windows standard.
List IANA time zones
Get the IANA time zones supported for my mailbox.

List Supported Time Zones

List all supported time zones for the user's mailbox.

API Details

  • API: Microsoft Outlook Mail API
  • Method: GET
  • Path: /me/outlook/supportedTimeZones
  • Operation ID: listSupportedTimeZones
  • Tag: LocaleAndTimeZone
  • OpenAPI: microsoft-outlook-mail-api.yaml

Sandbox

Mock server URL: http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/outlook/supportedTimeZones

Required Headers

  • Authorization: Bearer {access-token}

OAuth Scopes

  • MailboxSettings.Read

Parameters

| Parameter | In | Type | Required | Description | |-----------|-----|------|----------|-------------| | TimeZoneStandard | query | string | No | The time zone standard to use: "windows" or "iana" |

Example Request

curl -X GET "http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/outlook/supportedTimeZones?TimeZoneStandard=windows" \
  -H "Authorization: Bearer {access-token}"

Example Response

{
  "value": [
    {
      "alias": "Pacific Standard Time",
      "displayName": "(UTC-08:00) Pacific Time (US & Canada)"
    }
  ]
}

Instructions

Use this operation to retrieve the list of time zones supported for the user's mailbox configuration. Optionally specify the TimeZoneStandard query parameter to get time zones in either "windows" or "iana" format. This is useful when setting the user's time zone preference in mailbox settings.

Related skills