Create chat - Automate.ax

createChat creates a chat with Microsoft 365 users and automatically adds the connected user as an owner.

Example

automations/create-launch-chat.automation.ts

import { automation } from "automate.ax"
import { createChat } from "automate.ax/teams"

export default automation("Create launch chat", () => {
  createChat({
    chatType: "group",
    topic: "Launch room",
    participants: [
      { user: "alex@example.com" },
      { user: "guest-user-id", role: "guest" },
    ],
  })
})

Inputs

Input	Type	Required	Default	Description
`chatType`	`"oneOnOne" \| "group"`	Yes	—	Chat kind to create.
`participants`	`{ user: string; role?: "owner" \| "guest" }[]`	Yes	—	Other users by Entra ID or user principal name. Role defaults to `owner`.
`topic`	`string`	Group only	None	Non-empty group-chat title.
`account`	`string \| IntegrationAccountReference<"microsoft">`	No	Project default	Microsoft binding.

A one-to-one chat requires exactly one other participant and cannot have a topic. A group chat requires at least two other participants. Use guest only for guest users in the same tenant.

Output

Returns the created TeamsChat with chatId, chatType, and available topic, tenant, timestamps, and web URL. Graph may return an existing one-to-one chat between the same people rather than creating a duplicate.

⌘I