Care Context Linking Status

This webhook is sent after you call the Care Context Link API to notify you of the linking result. Check the status field to determine if the care context was successfully linked.

What to do next:

• If status is LINKED — the care context is now registered with ABDM. Other HIUs can request this data through ABDM’s consent flow.
• If status is ERRORED — check the error field for the failure reason and retry if needed.

Request

Headers:

• Eka-Webhook-Signature: <Eka Webhook Signature> Refer: Webhook Signature
• Content-Type: application/json

Body:

{
    "service": "abdm",
    "event": "abha.link_care_context",
    "event_time": 1749822309,
    "transaction_id": "<webhook transaction id>",
    "timestamp": 1749825214,
    "business_id": "<partner business id>",
    "client_id": "<partner client id>",
    "data": {
        "abha_address": "shyam@abdm",
        "hip_id": "<partner hip id>",
        "care_context_id": "c61f74f9-6f58-49b2-be18-8150bf0bd6ab",
        "status": "LINKED",
        "error": null,
        "retry_count":0,
        "oid": "<eka user id>",
        "partner_patient_id": "<partner user id>"
    }
}

Field Descriptions

• data: Contains additional details related to the event.
  • status: Care context linking status
    • LINKED, ERRORED
  • error: Failure reason in case of status ERRORED
  • retry_count: Number of retries to link