~%Insert

• Description
• Syntax
• Built-in property names
• Examples of use
• Deprecated macros

Description

When you paste a template into the current email message, this macro inserts the text of the specified entity into the current macro position.

Email

In case of emails, you can use:

• To, Cc, Bcc, or Subject to insert the text of the corresponding email fields.
• Today or Now to insert the current date or time.
• Recipient or Sender to insert their first, last, or full name.
• Mailbox Property, Profile Property, or Team Property to insert the text of the specified property.
• AAD Property to insert the text of the specified property.

Calendar

In case of calendar events, you can use:

• To, Cc, Subject, or Location to insert the text of the corresponding calendar event fields.
• Today or Now to insert the current date or time.
• Sender to insert the sender's first, last, or full name.
• Mailbox Property, Profile Property, or Team Property to insert the text of the specified property.
• AAD Property to insert the text of the specified property.

Syntax

~%Insert{
     "field":"to" | "cc" | "bcc" | "subject" | "location" |
        "today" | "now" |
        "recipient_first_name" | "recipient_full_name" | "recipient_last_name" |
        "sender_first_name" | "sender_full_name" | "sender_last_name" |
        "mailbox_property" | "profile_property" | "team_property" | "signature" |
        "aad_property" | "link_to_onedrive_file" | "link_to_sharepoint_file"
     // in case of properties and AAD
     "property":"textvalue",
     // in case of signature
     "property":"signature_name",
     // in case of today, now
     [ "format":"textvalue", ]
     [ "locale":"textvalue" ]
     // in case of link to OneDrive or SharePoint
     ("driveId":"textvalue",
     "fileId":"textvalue",
     "fileName":"textvalue",
     "permissions":"view" | "edit",
     "scope":"anonymous" | "organization" )
}

Works for

• Email templates.
• Calendar event templates.
• The macro is not supported for Mail Merge templates except for mailbox, profile, team, and AAD properties.

Built-in property names

• Built-in mailbox properties: emailaddress, displayname, timezone.
• Built-in profile properties: username, firstname, fullname, lastname, birthday, licensekey, emailaddress.
• Built-in team properties: teampassword, displayname, description.
• Special profile properties: DateFormat, DateLocale, DefaultOneDriveFolder, DefaultSharePointFolder.
• Special team properties: DateFormat, DateLocale, DefaultOneDriveFolder, DefaultSharePointFolder.
• AAD properties: those text properties mentioned in "Microsoft Graph REST API v1.0 User Properties" that can be changed by an Azure AD administrator.

Examples of use

~%Insert{
     "field":"team_property",
     "property":"Description"
}

Deprecated macros