Create Chat

Create a chat in Microsoft Teams.

Input

Field Definition Type Required

Chat

Chat Type Specifies the type of chat. Possible values are:
  • oneOnOne: indicates that the chat is a 1:1 chat.
  • group: indicates that the chat is a group chat.

Dropdown

TRUE
Topic Title of the chat. The chat title can be provided only if the chat is of group type.

Text

FALSE
User IDs Unique identifier for the user. List of String

FALSE

Output

Field Definition Type

Response

ID Unique identification of the chat.

Text
Topic Title of the chat. The chat title can be provided only if the chat is of group type.

Text
Chat Type Specifies the type of chat.

Text
Created Date Time Timestamp of when the chat message was created.

Date & Time
Last Updated Date Time Date and time at which the chat was renamed or list of members were last changed.

Date & Time
Status Code

Result of the operation. The connector returns an HTTP status code that indicates whether the action taken by the card succeeded or failed. For example:

  • A 201 Created status code indicates success where a new resource was created.
  • A 403 Forbidden error indicates that the HTTP request wasn't processed because the necessary permissions were missing.

For a full list of possible status codes, see HTTP status codes.

Number

Additional information

The user account that is used to make the Workflows connection is automatically added to the list of users by the connector. It is not necessary to pass in the User ID for the connected user.

Related topics

Microsoft Teams connector

Workflow elements

Guidance for Microsoft Teams connector

Microsoft Teams API overview