Share via

extensionAutoRunEventsArray.events object

  • Article

Configures the event that cause actions in an Outlook Add-in to run automatically. For example, see use smart alerts and the OnMessageSend and OnAppointmentSend events in your Outlook Add-ins.

Properties that reference this object type:

Syntax

{
  "type": "{string}",
  "actionId": "{string}",
  "options": {
    "sendMode": "promptUser | softBlock | block"
  }
}

Properties

type

Specifies the type of event. For supported types, see supported events.

Type
string

Required
✅

Constraints
Maximum string length: 64.

Supported values

actionId

Identifies the action that is taken when the event fires. The actionId must match with runtime.actions.id.

Type
string

Required
✅

Constraints
Maximum string length: 64.

Supported values

options

Configures how Outlook responds to the event.

Type
options

Required
—

Constraints

Supported values

Examples

{
  "events": [
    {
      "type": "newMessageComposeCreated",
      "actionId": "onNewMessageComposeCreated"
    },
    {
      "type": "messageSending",
      "actionId": "onMessageSending",
      "options": {
        "sendMode": "promptUser"
      }
    }
  ]
}