POST api/v2/{practiceId}/clinical/encounters/{encounterId}/followup/send

Schedule sending sms as part of visit followups for encounter

Request Information

URI Parameters

NameDescriptionTypeAdditional information
practiceId

globally unique identifier

Required

encounterId

globally unique identifier

Required

Body Parameters

Com.Healthbridge.Hhas.ClinicalPatientEngagement.Interface.Commands.SendEncounterRequireFollowupPatientSms
NameDescriptionTypeAdditional information
FollowupWithPatientRegardingVisitOutcomeId

globally unique identifier

None.

EncounterId

globally unique identifier

None.

PatientCommunication

Com.Healthbridge.Hhas.ClinicalPatientEngagement.Interface.ValueObjects.PatientCommunicationVo

None.

FollowUpReasons

Collection of string

None.

CorrelationIds

Collection of string

None.

OriginatedSystem

string

None.

Request Formats

application/json, text/json

Sample:
{
  "FollowupWithPatientRegardingVisitOutcomeId": "17c26214-3f89-4111-ad69-b45ef51ecf85",
  "EncounterId": "24476492-989c-4360-9127-e52367c16236",
  "PatientCommunication": {
    "PracticeId": "f70b0500-6f78-48a8-b30e-f13bbc2c3f14",
    "PatientId": "fad75184-d53e-4139-ab08-18e161f9aa01",
    "PatientName": "sample string 3",
    "PatientSurname": "sample string 4",
    "PatientCellphone": "sample string 5",
    "PatientDOB": "2025-08-06T01:02:00Z",
    "FollowUpDate": "2025-08-06T01:02:00Z",
    "DoctorName": "sample string 8",
    "CommunicationText": "sample string 9"
  },
  "FollowUpReasons": [
    "sample string 1",
    "sample string 2"
  ],
  "CorrelationIds": [
    "sample string 1",
    "sample string 2"
  ],
  "OriginatedSystem": "sample string 3"
}

application/xml, text/xml

Sample:
<SendEncounterRequireFollowupPatientSms xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Com.Healthbridge.Hhas.ClinicalPatientEngagement.Interface.Commands">
  <CorrelationIds xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns="http://mpsapi.healthbridge.com/platform/core/v1/command/">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </CorrelationIds>
  <OriginatedSystem xmlns="http://mpsapi.healthbridge.com/platform/core/v1/command/">sample string 3</OriginatedSystem>
  <EncounterId>24476492-989c-4360-9127-e52367c16236</EncounterId>
  <FollowUpReasons xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </FollowUpReasons>
  <FollowupWithPatientRegardingVisitOutcomeId>17c26214-3f89-4111-ad69-b45ef51ecf85</FollowupWithPatientRegardingVisitOutcomeId>
  <PatientCommunication xmlns:d2p1="http://mpsapi.healthbridge.com/clinical/clinical/v1/patientnotification/">
    <d2p1:CommunicationText>sample string 9</d2p1:CommunicationText>
    <d2p1:DoctorName>sample string 8</d2p1:DoctorName>
    <d2p1:FollowUpDate>2025-08-06T01:02:00.5594512+02:00</d2p1:FollowUpDate>
    <d2p1:PatientCellphone>sample string 5</d2p1:PatientCellphone>
    <d2p1:PatientDOB>2025-08-06T01:02:00.5594512+02:00</d2p1:PatientDOB>
    <d2p1:PatientId>fad75184-d53e-4139-ab08-18e161f9aa01</d2p1:PatientId>
    <d2p1:PatientName>sample string 3</d2p1:PatientName>
    <d2p1:PatientSurname>sample string 4</d2p1:PatientSurname>
    <d2p1:PracticeId>f70b0500-6f78-48a8-b30e-f13bbc2c3f14</d2p1:PracticeId>
  </PatientCommunication>
</SendEncounterRequireFollowupPatientSms>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'System.Web.Http.ModelBinding.JQueryMvcFormUrlEncodedFormatter' to write type 'SendEncounterRequireFollowupPatientSms'.

Response Information

Resource Description

Com.Healthbridge.Core.CommonDomain.Interface.ValueObjects.RestApiResultOfSystem.Guid
NameDescriptionTypeAdditional information
Sucess

boolean

None.

ResponseCode

integer

None.

ResponseMessage

string

None.

Data

globally unique identifier

None.

Links

Collection of Com.Healthbridge.Core.CommonDomain.Interface.ValueObjects.RestApiLink

None.

Response Formats

application/json, text/json

Sample:
{
  "Sucess": true,
  "ResponseCode": 2,
  "ResponseMessage": "sample string 3",
  "Data": "0d34ed15-a7d1-41f7-b8c2-ac4f44b50a57",
  "Links": [
    {
      "Rel": "sample string 1",
      "HRef": "sample string 2"
    },
    {
      "Rel": "sample string 1",
      "HRef": "sample string 2"
    }
  ]
}

application/xml, text/xml

Sample:
<RestApiResultOfguid xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Com.Healthbridge.Core.CommonDomain.Interface.ValueObjects">
  <Data>0d34ed15-a7d1-41f7-b8c2-ac4f44b50a57</Data>
  <Links>
    <RestApiLink>
      <HRef>sample string 2</HRef>
      <Rel>sample string 1</Rel>
    </RestApiLink>
    <RestApiLink>
      <HRef>sample string 2</HRef>
      <Rel>sample string 1</Rel>
    </RestApiLink>
  </Links>
  <ResponseCode>2</ResponseCode>
  <ResponseMessage>sample string 3</ResponseMessage>
  <Sucess>true</Sucess>
</RestApiResultOfguid>