For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • Home
    • About the Referral Exchange (RefX)
  • Getting Started
    • API Overview
    • Accessing our APIs
    • Authentication
    • Content Types
    • Request and Response Limits
    • Create and Edit Referrals
    • Print Referrals
    • List Referrals
    • Cancel & Withdraw Referrals
    • Timeline Events
    • Implementation Reference
  • Concepts
    • Referral Lifecycle & Statuses
    • Referral Notes
    • Browser Tab Handling
    • Referral Link
    • NEHR Integration
  • API Reference
      • POSTCreate a note for a referral
    • Changelog
LogoLogo
API ReferenceReferral Notes

Create a note for a referral

POST
/api/v1/referrals/:referralId/notes
POST
/api/v1/referrals/:referralId/notes
$curl -X POST https://dummy-url-see-smartcms-spec/api/v1/referrals/referralId/notes \
> -H "Authorization: <apiKey>" \
> -H "Content-Type: application/json" \
> -d '{
> "authorHciCode": "HCI12345",
> "institutionIdType": "hci",
> "institutionId": "SGH001"
>}'
1{
2 "id": "a3f1c9e2-7b4d-4f8a-9c2e-5d6b7e8f9a01",
3 "content": "Patient has been advised to follow up in 2 weeks for review of medication adherence.",
4 "authorHciCode": "HCI12345",
5 "authorName": "Dr. Jane Tan",
6 "createdAt": 1685606400,
7 "updatedAt": 1685606400
8}
Was this page helpful?
Previous

Create a new referral link

Next
Built with

Authentication

Authorizationstring

API key to authenticate for external integrations. Use the format: “ApiKey insert-token-here”

Path parameters

referralIdstringRequiredformat: "uuid"
Referral ID

Request

This endpoint expects an object.
authorHciCodestringRequired
Author HCI code. Must be already tied to your system.
institutionIdTypeenumRequired
The type of institution ID
Allowed values:
institutionIdstringRequired
The institution ID
contentstringOptional<=8000 characters

Note content - plaintext.

Response

idstring
contentstring
authorHciCodestring
authorNamestring
createdAtdouble
updatedAtdouble

Errors

401
Unauthorized Error