Skip to main content

teams meeting add

Create a new online meeting

Usage​

m365 teams meeting add [options]

Options​

-s, --startTime [startTime]

The start time of the meeting. If not specified, the start time will be set to the current time.

-e, --endTime [endTime]

The end time of the meeting. If not specified, the end time will be set to one hour after the start time.

--subject [subject]

The subject of the meeting.

-p, --participantUserNames [participantUserNames]

A comma-separated list of participant UPNs.

--organizerEmail [organizerEmail]

The organizer's email address.

-r, --recordAutomatically

When using this flag, the meeting will be recorded automatically.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

info

This command creates a standalone meeting that is not associated with any event on the user's calendar; therefore, meetings created via this command will not show on the user's calendar.

To create an online meeting for a specific organizer, use the organizerEmail option along with app-only permissions. The application should have the OnlineMeetings.ReadWrite.All permissions, and a special policy should be assigned to the user specified in the organizerEmail option. You can find more information on how to assign this policy to a user here.

Examples​

Create a new online meeting for the currently logged-in user, starting immediately and ending after one hour.

m365 teams meeting add

Create a new online meeting for the currently logged-in user, with a specified start date and a duration of one hour.

m365 teams meeting add --startTime "2025-09-21T13:30:00Z"

Create a new online meeting for the currently logged-in user, with specified end date the current date as the start date.

m365 teams meeting add --endTime "2025-09-21T23:55:00Z"

Create a new online meeting for the currently logged-in user, with specified start and end dates.

m365 teams meeting add --startTime "2025-09-21T13:30:00Z" --endTime "2025-09-21T23:55:00Z"

Create a new online meeting for the currently logged-in user, with a specified subject.

m365 teams meeting add --startTime "2025-09-21T13:30:00Z" --endTime "2025-09-21T23:55:00Z" --subject "Test Subject"

Create a new online meeting for the currently logged-in user, with a specified subject and a list of participantUserNames.

m365 teams meeting add --subject "Test Subject" --participantUserNames "john.doe@contoso.com,olga.manager@contoso.com"

Create a new online meeting for the currently logged-in user, with a specified subject, a list of participantUserNames, and automatic meeting recording.

m365 teams meeting add --subject "Test Subject" --participantUserNames "john.doe@contoso.com,olga.manager@contoso.com" --recordAutomatically

Create a new online meeting for a selected organizer, with a specified subject, a list of participantUserNames, and automatic meeting recording. This option is available for app-only permissions.

m365 teams meeting add --organizerEmail "john.doe@contoso.com" --subject "Test Subject" --participantUserNames "olga.manager@contoso.com" --recordAutomatically

Response​

{
  "id": "abc",
  "creationDateTime": "2023-07-25T19:29:32.033109Z",
  "startDateTime": "2023-07-17T03:00:00Z",
  "endDateTime": "2023-07-17T04:00:00Z",
  "joinUrl": "https://teams.microsoft.com/l/meetup-join/abc",
  "joinWebUrl": "https://teams.microsoft.com/l/meetup-join/abc",
  "meetingCode": "12345",
  "subject": "Subject",
  "isBroadcast": false,
  "autoAdmittedUsers": "unknownFutureValue",
  "outerMeetingAutoAdmittedUsers": null,
  "isEntryExitAnnounced": false,
  "allowedPresenters": "everyone",
  "allowMeetingChat": "enabled",
  "shareMeetingChatHistoryDefault": "none",
  "allowTeamworkReactions": true,
  "allowAttendeeToEnableMic": true,
  "allowAttendeeToEnableCamera": true,
  "recordAutomatically": false,
  "anonymizeIdentityForRoles": [],
  "capabilities": [],
  "videoTeleconferenceId": null,
  "externalId": null,
  "iCalUid": null,
  "meetingType": null,
  "allowParticipantsToChangeName": false,
  "allowRecording": true,
  "allowTranscription": true,
  "meetingMigrationMode": null,
  "broadcastSettings": null,
  "audioConferencing": null,
  "meetingInfo": null,
  "participants": {
    "organizer": {
      "upn": "john.doe@contoso.com",
      "role": "presenter",
      "identity": {
        "application": null,
        "device": null,
        "user": {
          "id": "12345678-1234-1234-1234-12345678",
          "displayName": null,
          "tenantId": "12345678-1234-1234-1234-12345678",
          "identityProvider": "AAD"
        }
      }
    },
    "attendees": [
      {
        "upn": "adele.vance@contoso.com",
        "role": "attendee",
        "identity": {
          "application": null,
          "device": null,
          "user": {
            "id": "12345678-1234-1234-1234-12345678",
            "displayName": null,
            "tenantId": "12345678-1234-1234-1234-12345678,
            "identityProvider": "AAD"
          }
        }
      }
    ]
  },
  "lobbyBypassSettings": {
    "scope": "unknownFutureValue",
    "isDialInBypassEnabled": false
  },
  "joinMeetingIdSettings": {
    "isPasscodeRequired": true,
    "joinMeetingId": "12345",
    "passcode": "123456"
  },
  "chatInfo": {
    "threadId": "abc",
    "messageId": "0",
    "replyChainMessageId": null
  },
  "joinInformation": {
    "content": "textContent",
    "contentType": "html"
  },
  "watermarkProtection": {
    "isEnabledForContentSharing": false,
    "isEnabledForVideo": false
  }
}
CTRL + M