mailboxSettings

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/azure-ad/json-schema/azure-ad-microsoft-graph-mailbox-settings-schema.json",
  "title": "mailboxSettings",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/azure-ad-invitations-user-api-openapi.yml#/components/schemas/microsoft.graph.mailboxSettings",
  "type": "object",
  "properties": {
    "archiveFolder": {
      "type": [
        "string",
        "null"
      ],
      "description": "Folder ID of an archive folder for the user."
    },
    "automaticRepliesSetting": {
      "$ref": "#/$defs/microsoft.graph.automaticRepliesSetting"
    },
    "dateFormat": {
      "type": [
        "string",
        "null"
      ],
      "description": "The date format for the user's mailbox."
    },
    "delegateMeetingMessageDeliveryOptions": {
      "$ref": "#/$defs/microsoft.graph.delegateMeetingMessageDeliveryOptions"
    },
    "language": {
      "$ref": "#/$defs/microsoft.graph.localeInfo"
    },
    "timeFormat": {
      "type": [
        "string",
        "null"
      ],
      "description": "The time format for the user's mailbox."
    },
    "timeZone": {
      "type": [
        "string",
        "null"
      ],
      "description": "The default time zone for the user's mailbox."
    },
    "userPurpose": {
      "$ref": "#/$defs/microsoft.graph.userPurpose"
    },
    "workingHours": {
      "$ref": "#/$defs/microsoft.graph.workingHours"
    }
  },
  "additionalProperties": {
    "type": "object"
  },
  "$defs": {
    "microsoft.graph.automaticRepliesSetting": {
      "title": "automaticRepliesSetting",
      "type": "object",
      "properties": {
        "externalAudience": {
          "$ref": "#/$defs/microsoft.graph.externalAudienceScope"
        },
        "externalReplyMessage": {
          "type": [
            "string",
            "null"
          ],
          "description": "The automatic reply to send to the specified external audience, if Status is AlwaysEnabled or Scheduled."
        },
        "internalReplyMessage": {
          "type": [
            "string",
            "null"
          ],
          "description": "The automatic reply to send to the audience internal to the signed-in user's organization, if Status is AlwaysEnabled or Scheduled."
        },
        "scheduledEndDateTime": {
          "$ref": "#/$defs/microsoft.graph.dateTimeTimeZone"
        },
        "scheduledStartDateTime": {
          "$ref": "#/$defs/microsoft.graph.dateTimeTimeZone"
        },
        "status": {
          "$ref": "#/$defs/microsoft.graph.automaticRepliesStatus"
        }
      },
      "additionalProperties": {
        "type": "object"
      }
    },
    "microsoft.graph.automaticRepliesStatus": {
      "title": "automaticRepliesStatus",
      "enum": [
        "disabled",
        "alwaysEnabled",
        "scheduled"
      ],
      "type": "string"
    },
    "microsoft.graph.dateTimeTimeZone": {
      "title": "dateTimeTimeZone",
      "type": "object",
      "properties": {
        "dateTime": {
          "type": "string",
          "description": "A single point of time in a combined date and time representation ({date}T{time}; for example, 2017-08-29T04:00:00.0000000)."
        },
        "timeZone": {
          "type": [
            "string",
            "null"
          ],
          "description": "Represents a time zone, for example, 'Pacific Standard Time'. See below for more possible values."
        }
      },
      "additionalProperties": {
        "type": "object"
      }
    },
    "microsoft.graph.dayOfWeek": {
      "title": "dayOfWeek",
      "enum": [
        "sunday",
        "monday",
        "tuesday",
        "wednesday",
        "thursday",
        "friday",
        "saturday"
      ],
      "type": "string"
    },
    "microsoft.graph.delegateMeetingMessageDeliveryOptions": {
      "title": "delegateMeetingMessageDeliveryOptions",
      "enum": [
        "sendToDelegateAndInformationToPrincipal",
        "sendToDelegateAndPrincipal",
        "sendToDelegateOnly"
      ],
      "type": "string"
    },
    "microsoft.graph.externalAudienceScope": {
      "title": "externalAudienceScope",
      "enum": [
        "none",
        "contactsOnly",
        "all"
      ],
      "type": "string"
    },
    "microsoft.graph.localeInfo": {
      "title": "localeInfo",
      "type": "object",
      "properties": {
        "displayName": {
          "type": [
            "string",
            "null"
          ],
          "description": "A name representing the user's locale in natural language, for example, 'English (United States)'."
        },
        "locale": {
          "type": [
            "string",
            "null"
          ],
          "description": "A locale representation for the user, which includes the user's preferred language and country/region. For example, 'en-us'. The language component follows 2-letter codes as defined in ISO 639-1, and the country component follows 2-letter codes as defined in ISO 3166-1 alpha-2."
        }
      },
      "additionalProperties": {
        "type": "object"
      }
    },
    "microsoft.graph.timeZoneBase": {
      "title": "timeZoneBase",
      "type": "object",
      "properties": {
        "name": {
          "type": [
            "string",
            "null"
          ],
          "description": "The name of a time zone. It can be a standard time zone name such as 'Hawaii-Aleutian Standard Time', or 'Customized Time Zone' for a custom time zone."
        }
      },
      "additionalProperties": {
        "type": "object"
      }
    },
    "microsoft.graph.userPurpose": {
      "title": "userPurpose",
      "enum": [
        "user",
        "linked",
        "shared",
        "room",
        "equipment",
        "others",
        "unknownFutureValue"
      ],
      "type": "string"
    },
    "microsoft.graph.workingHours": {
      "title": "workingHours",
      "type": "object",
      "properties": {
        "daysOfWeek": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/microsoft.graph.dayOfWeek"
          },
          "description": "The days of the week on which the user works."
        },
        "endTime": {
          "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?$",
          "type": [
            "string",
            "null"
          ],
          "description": "The time of the day that the user stops working.",
          "format": "time"
        },
        "startTime": {
          "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?$",
          "type": [
            "string",
            "null"
          ],
          "description": "The time of the day that the user starts working.",
          "format": "time"
        },
        "timeZone": {
          "$ref": "#/$defs/microsoft.graph.timeZoneBase"
        }
      },
      "additionalProperties": {
        "type": "object"
      }
    }
  }
}