Create thread

Start a new conversation by first creating a thread.

A new conversation, conversation thread, and post are created in the group. Use reply thread or reply post to further post to that thread.

Note: You can also start a new thread in an existing conversation.

Prerequisites

One of the following scopes is required to execute this API: Group.ReadWrite.All

HTTP request

POST /groups/{id}/threads

Request headers

Header Value
Authorization Bearer . Required.
Content-Type application/json

Request body

In the request body, supply a JSON representation of conversationThread object containing a post.

Response

If successful, this method returns 201, Created response code and conversationThread object in the response body.

Example

Request

Here is an example of the request.

POST https://graph.microsoft.com/v1.0/groups/{id}/threads
Content-type: application/json

{
  "topic": "New Conversation Thread Topic",
  "posts": [{
    "body": {
      "contentType": "html",
      "content": "this is body content"
    },
    "newParticipants": [{
      "emailAddress": {
        "name": "Alex Darrow",
        "address": "alexd@contoso.com"
      }
    }]
  }]
}
Response

Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 201 OK
Content-type: application/json
Content-length: 419

{
  "toRecipients": [
    {
      "emailAddress": {
        "name": "name-value",
        "address": "address-value"
      }
    }
  ],
  "topic": "topic-value",
  "hasAttachments": true,
  "lastDeliveredDateTime": "datetime-value",
  "uniqueSenders": [
    "uniqueSenders-value"
  ],
  "ccRecipients": [
    {
      "emailAddress": {
        "name": "name-value",
        "address": "address-value"
      }
    }
  ]
}