Using the additionalData Field
Home ยป RxWare Developer Site ยป Case Updates API ยป Using the additionalData Field
ENDPOINT: POST /v1/patients/{patientId}/event
Endpoint Example
For the Case Updates API, you will need to replace the
Example: POST /v1/patients/ha182039129/event
{patientId}
variable with your patient's HA ID.Example: POST /v1/patients/ha182039129/event
Case Update messages may contain any variable data you choose, which RxWare will insert in the appropriate place within the SMS message without processing or reading the data.
When this variable data is included, additionalData
with a key-value pair must be included in the call for the name
field.
Did You Know?
The
That's right, it's totally up to you what you communicate in the key value pair inside the
additionalData
field can contain *anything* you want it to!
That's right, it's totally up to you what you communicate in the key value pair inside the
additionalData
array
Heads Up!
The
If you leave this array blank, you'll get a "request data is empty" response.
additionalData
array must contain a key-value pair.If you leave this array blank, you'll get a "request data is empty" response.
additionalData
Examples
Here we are able to add a variable date
field in the body of the notify.sms.next.call
SMS message to notify the patient of an upcoming outreach attempt:
{
"status": {
"name": "notify.sms.next.call",
"text": "",
"additionalData":[
{
"key:"date",
"value":"06/22/2024"
}
]
},
"phoneNumber": "{{test-user-phone-number}}",
"externalId": "{{test-user-external-user-id}}",
"supportProgramId": "{{partners-support-program-id}}"
}
Example code to notate a patient’s Copay Savings Card details using the additionalData
field on the financial.support.status
event:
{
"status": {
"name": "financial.support.status",
"text": "approved",
"additionalData": [
{
"key": "coPayMember",
"value": "098765999546824"
},
{
"key": "coPayBinNumber",
"value": "610279"
},
{
"key": "pharmacyphone",
"value": "(704) 555-5555"
}
]
},
"phoneNumber": "{{test-user-phone-number}}",
"externalId": "{{test-user-external-user-id}}",
"supportProgramId": "{{partners-support-program-id}}"
}
Endpoint Example
For the Direct-to-SMS endpoint, you will need to replace the
Example: POST /v1/patients/ha182039129/event
{patientId}
variable with your patient's HA ID.Example: POST /v1/patients/ha182039129/event