Create a new conversation

This operation creates a new conversation within an organization. The following conversation types are supported:

Secure Conversations (type: "secure")

A secure conversation can be started with a single contact or a group of contacts. All contacts must be patients and either have a Spruce account or a pending secure invite.

Note Conversations (type: "note")

A note conversation is an internal-only conversation for documenting information. Notes can optionally include organization members/groups and can be associated with contacts for organizational purposes (via associatedContactIds). Associated contacts will not have access to the note.

Asynchronous Message Processing

If a message is included in the conversation creation request, the message will be posted asynchronously after the conversation is created. The API will immediately return the conversation details along with a postMessageRequestId that can be used to track when the message is actually sent.

The postMessageRequestId returned in the response can be matched against the requestID field of the conversationItem.created webhook event to identify when the message has been successfully posted to the conversation.