API Reference

Add a participant to a Conversation

post
https://project-api.zapehr.com/v1/messaging/conversation//participant

Add a participant to a Conversation. Conversations allow you to build multi-channel bi-directional messaging workflows. For example, you might create a Conversation where a provider messages with a patient through a web app, and the patient receives and responds to messages via SMS on their phone.

Access Policy Requirements:
Action: Messaging:ConversationAddParticipant
Access Policy Resource: Messaging:Conversation
Action: FHIR:Read
Access Policy Resource: FHIR:Encounter
Action: FHIR:Update
Access Policy Resource: FHIR:Encounter

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

ID of the Conversation from the https://extensions.fhir.oystehr.com/encounter-virtual-service-pre-release extension if on FHIR R4B, or from Encounter.virtual-service if on FHIR R5.

Body Params
string
required

A valid FHIR Encounter relative reference in the format: Encounter/some-uuid. This reference must be a valid Encounter in the FHIR store which has the https://extensions.fhir.oystehr.com/encounter-virtual-service-pre-release extension from being created by POST /message/conversation.

participants
array of objects
required
participants*
Responses
204

Participants were added to the Conversation successfully.

Updated about 1 year ago

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 year ago