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. String FALSE
User IDs Unique identifier for the user. List of String FALSE

Output

Field Definition Type
Response    
ID Unique identification of the chat. String
Topic Title of the chat. The chat title can be provided only if the chat is of group type. String
Chat Type Specifies the type of chat. String
Created Date Time Timestamp of when the chat message was created. Date and Time
Last Updated Date Time Date and time at which the chat was renamed or list of members were last changed. Date and Time
Status Code Result of the operation. The HTTP status code is returned by the connector and 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 was not 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

About the elements of Okta Workflows

Guidance for Microsoft Teams connector

Microsoft Teams API overview