mailboxSettings

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/microsoft-loop/json-schema/microsoft-loop-microsoft-graph-mailbox-settings-schema.json",
  "title": "mailboxSettings",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/microsoft-loop-openapi.yml#/components/schemas/microsoft.graph.mailboxSettings",
  "required": [
    "@odata.type"
  ],
  "type": "object",
  "properties": {
    "archiveFolder": {
      "type": [
        "string",
        "null"
      ],
      "description": "Folder ID of an archive folder for the user."
    },
    "automaticRepliesSetting": {
      "anyOf": [
        {
          "$ref": "#/$defs/microsoft.graph.automaticRepliesSetting"
        },
        {
          "type": [
            "object",
            "null"
          ]
        }
      ],
      "description": "Configuration settings to automatically notify the sender of an incoming email with a message from the signed-in user."
    },
    "dateFormat": {
      "type": [
        "string",
        "null"
      ],
      "description": "The date format for the user's mailbox."
    },
    "delegateMeetingMessageDeliveryOptions": {
      "anyOf": [
        {
          "$ref": "#/$defs/microsoft.graph.delegateMeetingMessageDeliveryOptions"
        },
        {
          "type": [
            "object",
            "null"
          ]
        }
      ],
      "description": "If the user has a calendar delegate, this specifies whether the delegate, mailbox owner, or both receive meeting messages and meeting responses. The possible values are: sendToDelegateAndInformationToPrincipal, sendToDelegateAndPrincipal, sendToDelegateOnly."
    },
    "language": {
      "anyOf": [
        {
          "$ref": "#/$defs/microsoft.graph.localeInfo"
        },
        {
          "type": [
            "object",
            "null"
          ]
        }
      ],
      "description": "The locale information for the user, including the preferred language and country/region."
    },
    "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": {
      "anyOf": [
        {
          "$ref": "#/$defs/microsoft.graph.userPurpose"
        },
        {
          "type": [
            "object",
            "null"
          ]
        }
      ],
      "description": "The purpose of the mailbox. Differentiates a mailbox for a single user from a shared mailbox and equipment mailbox in Exchange Online. The possible values are: user, linked, shared, room, equipment, others, unknownFutureValue. Read-only."
    },
    "workingHours": {
      "anyOf": [
        {
          "$ref": "#/$defs/microsoft.graph.workingHours"
        },
        {
          "type": [
            "object",
            "null"
          ]
        }
      ],
      "description": "The days of the week and hours in a specific time zone that the user works."
    },
    "@odata.type": {
      "type": "string"
    }
  },
  "$defs": {
    "microsoft.graph.automaticRepliesSetting": {
      "title": "automaticRepliesSetting",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "externalAudience": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.externalAudienceScope"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "The set of audience external to the signed-in user's organization who will receive the ExternalReplyMessage, if Status is AlwaysEnabled or Scheduled. The possible values are: none, contactsOnly, all."
        },
        "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": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.dateTimeTimeZone"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "The date and time that automatic replies are set to end, if Status is set to Scheduled."
        },
        "scheduledStartDateTime": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.dateTimeTimeZone"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "The date and time that automatic replies are set to begin, if Status is set to Scheduled."
        },
        "status": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.automaticRepliesStatus"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Configurations status for automatic replies. The possible values are: disabled, alwaysEnabled, scheduled."
        },
        "@odata.type": {
          "type": "string"
        }
      }
    },
    "microsoft.graph.automaticRepliesStatus": {
      "title": "automaticRepliesStatus",
      "enum": [
        "disabled",
        "alwaysEnabled",
        "scheduled"
      ],
      "type": "string"
    },
    "microsoft.graph.dateTimeTimeZone": {
      "title": "dateTimeTimeZone",
      "required": [
        "@odata.type"
      ],
      "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."
        },
        "@odata.type": {
          "type": "string"
        }
      }
    },
    "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",
      "required": [
        "@odata.type"
      ],
      "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."
        },
        "@odata.type": {
          "type": "string"
        }
      }
    },
    "microsoft.graph.timeZoneBase": {
      "title": "timeZoneBase",
      "required": [
        "@odata.type"
      ],
      "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."
        },
        "@odata.type": {
          "type": "string"
        }
      }
    },
    "microsoft.graph.userPurpose": {
      "title": "userPurpose",
      "enum": [
        "user",
        "linked",
        "shared",
        "room",
        "equipment",
        "others",
        "unknownFutureValue"
      ],
      "type": "string"
    },
    "microsoft.graph.workingHours": {
      "title": "workingHours",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "daysOfWeek": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "$ref": "#/$defs/microsoft.graph.dayOfWeek"
              },
              {
                "type": [
                  "object",
                  "null"
                ]
              }
            ]
          },
          "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": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.timeZoneBase"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "The time zone to which the working hours apply."
        },
        "@odata.type": {
          "type": "string"
        }
      }
    }
  }
}