Campaign Subscription
Home Β» RxWare Developer Site Β» Case Updates API Β» Campaign Subscription
ENDPOINT: POSTΒ
/v1/patients/{patientId}/subscribe-campaign
Endpoint Example
For the User Updates API endpoint, you will need to replace the
Example: POST /v1/patients/ha98402932/subscribe-campaign
{patientId}
variable with your patient's HA ID.Example: POST /v1/patients/ha98402932/subscribe-campaign
Campaign Subscription
This API call is used by our partners to provide a set series of updates to the patient, via an initial call and then subsequent scheduled events within pre-determined parameters.
A campaign subscription will:
- Update the patient’s status in our database and subscribe him/her to the series;
- Create an initial patient interaction, notification, or call to action;
- Schedule a subsequent patient interaction(s), notification(s), or call(s) to action
Specific campaign names and values can be mapped to various content and business rules that the Partner would like to enable for patients and caregivers. Events are mapped to the user experience as built by the partner with HelpAround by using one of its Gateway tools.
Here is an example of subscribing a patient to a campaign:
{
"name": "campaign_name",
"additionalData": [
{
"key": "key 1",
"value": "value 1"
},
{
"key": "key 2",
"value": "value 2"
},
{
"key": "key 3",
"value": "value 3"
}
],
"phoneNumber": "{{test-user-phone-number}}",
"externalId": "{{test-user-external-user-id}}",
"supportProgramId": "{{partners-support-program-id}}"
}
Standard Response Codes
Status | Code | Message | Description |
---|---|---|---|
200 | N/A | Patient updated successfully | Patient updated successfully |
401 | 0 | Unauthorized | Please verify with RxWare that you are authorized to use the RxWare API. |
400 | 1006 | Patient Not Found | Patient cannot be found in the system. |
400 | 2002 | Invalid Support Program ID | This means that the supportProgramId you provided is invalid.Please check your Support Program ID. |
400 | 1005 | User Previously Unsubscribed | |
403 | 403 | Invalid Token | This means that the bearer token you supplied is not valid for this Support Program. Please verify your credentials. |