Create Conversation

Create a new conversation by including a thread and a post.

Use reply thread or reply post to further post to that conversation.


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

HTTP request

POST /groups/{id}/conversations

Request headers

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

Request body

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


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



Here is an example of the request.

Content-type: application/json

  "topic": "New Conversation Topic",
  "threads": [{
    "posts": [{
      "body": {
        "contentType": "html",
        "content": "this is body content"
      "newParticipants": [{
        "emailAddress": {
          "name": "Alex Darrow",
          "address": ""

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 200 OK
Content-type: application/json
Content-length: 201

  "topic": "topic-value",
  "hasAttachments": true,
  "lastDeliveredDateTime": "2016-10-19T10:37:00Z",
  "uniqueSenders": [
  "preview": "preview-value",
  "id": "id-value"