---
updatedAt: 2026-08-07T16:25:02.000Z
agentTools:
  projectIndex: https://docs.elationhealth.com/llms.txt
---

# Create Thread Message

Create a new thread message.

# OpenAPI definition

```json
{
  "components": {
    "schemas": {
      "Document": {
        "properties": {
          "authoring_practice": {
            "format": "int64",
            "type": "integer"
          },
          "chart_date": {
            "description": "The creation date of the patient chart.",
            "format": "date-time",
            "type": "string"
          },
          "created_date": {
            "description": "The creation date of the document.",
            "format": "date-time",
            "readOnly": true,
            "type": [
              "string",
              "null"
            ]
          },
          "deleted_date": {
            "description": "The deleted date of the document.",
            "format": "date-time",
            "readOnly": true,
            "type": [
              "string",
              "null"
            ]
          },
          "document_date": {
            "description": "The date of the document. In most cases it's the same as the creation date. For some documents, like visit notes, it's the date of the visit note.",
            "format": "date-time",
            "type": "string"
          },
          "document_type": {
            "readOnly": true,
            "type": [
              "integer",
              "null"
            ]
          },
          "id": {
            "format": "int64",
            "type": "integer"
          },
          "last_modified": {
            "format": "date-time",
            "type": "string"
          },
          "patient": {
            "format": "int64",
            "type": "integer"
          },
          "sign_date": {
            "description": "The date of when the document was signed (if signed).",
            "format": "date-time",
            "readOnly": true,
            "type": [
              "string",
              "null"
            ]
          },
          "signed_by": {
            "description": "The id of whoever signed the document (if signed).",
            "readOnly": true,
            "type": "integer"
          }
        },
        "required": [
          "authoring_practice",
          "chart_date",
          "document_date",
          "id",
          "patient"
        ],
        "type": "object"
      },
      "ThreadMessage": {
        "properties": {
          "body": {
            "description": "The actual message body.",
            "type": "string"
          },
          "id": {
            "readOnly": true,
            "type": "integer"
          },
          "patient": {
            "description": "The patient id.",
            "format": "int64",
            "readOnly": true,
            "type": "integer"
          },
          "practice": {
            "description": "The practice id.",
            "format": "int64",
            "readOnly": true,
            "type": "integer"
          },
          "send_date": {
            "description": "The date of when the message was sent.",
            "format": "date-time",
            "type": "string"
          },
          "sender": {
            "description": "The id of who sent the message.",
            "type": "integer"
          },
          "thread": {
            "description": "The message thread id.",
            "format": "int64",
            "type": "integer"
          },
          "to_document": {
            "$ref": "#/components/schemas/Document"
          }
        },
        "required": [
          "body",
          "send_date",
          "sender"
        ],
        "type": "object"
      }
    },
    "securitySchemes": {
      "oauth2": {
        "flows": {
          "clientCredentials": {
            "scopes": {
              "act_as_user": "Impersonate a provider via X-On-Behalf-Of (combinable with apiv2 or system scopes)",
              "apiv2": "Full access to the API",
              "system/{resource_name}.read": "Read access to a specific resource",
              "system/{resource_name}.write": "Write access to a specific resource"
            },
            "tokenUrl": "/api/2.0/oauth2/token/"
          }
        },
        "type": "oauth2"
      }
    }
  },
  "info": {
    "contact": {
      "name": "Elation Health",
      "url": "https://www.elationhealth.com/"
    },
    "description": "Elation Health API v2.0",
    "title": "Messaging API",
    "version": "2.0.0"
  },
  "openapi": "3.1.0",
  "paths": {
    "/api/2.0/thread_messages/": {
      "post": {
        "description": "Create a new thread message.",
        "operationId": "thread_messages_create",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ThreadMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ThreadMessage"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "oauth2": []
          }
        ],
        "summary": "Create Thread Message",
        "tags": [
          "Thread Messages"
        ],
        "x-el8-docs-category": "Messaging API",
        "x-el8-docs-versions": [
          "2.1",
          "2.0"
        ]
      }
    }
  },
  "servers": [
    {
      "description": "Sandbox Server",
      "url": "https://sandbox.elationemr.com"
    },
    {
      "description": "Production Server",
      "url": "https://api.app.elationemr.com"
    }
  ],
  "x-readme": {
    "proxy-enabled": true
  }
}
```