Microsoft Teams Bot icon

Microsoft Teams Bot

Use Bot Framework conversation and activity APIs for Microsoft Teams bots

Actions23

Conversation → Create Conversation

AI-generated

Summary

Send a request to create a new conversation in Microsoft Teams using the Bot Framework API by providing the required service URL and the raw JSON payload for the conversation.

Inputs

  • Service URL (required) — The Bot Framework service URL where the request is sent, typically obtained from a trigger output.
  • Conversation JSON (required) — Raw JSON string that represents the conversation details for the POST /v3/conversations endpoint.
  • Execution Options — Optional parameters to control retries, debug output inclusion, and shaping of output data (pass through, merge, or response only).

Output shape

a JSON object containing the HTTP method used, request path, and the response from the Microsoft Teams Bot Framework API for conversation creation. The output can optionally include debug metadata and either the full response, merged input-output JSON, or response only depending on output mode.

The raw conversation JSON input must be a valid JSON object string; invalid or non-object JSON results in error. Supports retrying failed requests based on configured retry count and delay. Output can include debug info if enabled. Output mode controls how data is returned for downstream nodes.

Examples

Example 1: Create a new conversation with a specified JSON payload defining conversation members and properties.

Specify the 'Service URL' from your Teams trigger output and supply the 'Conversation JSON' defining the conversation structure. Optionally configure execution options such as retries and output format.

Links

Discussion