Developer Portal

Welcome to PatientPulse
Developer Hub

Get your API credentials, explore environments, manage webhooks, and start integrating with India's most comprehensive healthcare API platform.

All Systems Operational API v2.0 FHIR R4 Compliant ABDM Certified

Your API Keys

Sandbox Mode

Use these keys to authenticate requests to the PatientPulse API. Never expose your secret key in client-side code.

Publishable Key
pk pp_sandbox_pk_a3f8c2d7e9b1f4a6c8d2e7f9b1a3c5d7e9f1b3a5c7
Secret Key
sk pp_sandbox_sk_••••••••••••••••••••••••••••••••••
⚠ Sandbox Environment

This key is connected to the sandbox. No real patient data is processed. Switch to Production keys after testing.

Environment Setup

Copy to your .env file to get started.

.env
# PatientPulse API
PP_API_BASE_URL=https://api.patientpulse.in/v1
PP_API_KEY=pp_sandbox_sk_your_key_here
PP_ENV=sandbox

# ABDM (Ayushman Bharat Digital Mission)
ABDM_INTEGRATION_ENABLED=true
ABDM_CONNECTOR_MODE=stub
ABDM_CONNECTOR_BASE_URL=https://abdm-sandbox.patientpulse.in

# AI Features
AI_ENABLED=true
AI_EXTERNAL_LLM_ENABLED=true
OPENAI_API_KEY=sk-your-openai-key

# Database
DATABASE_URL=postgresql://user:pass@localhost:5432/pp_sandbox

Webhooks

Receive real-time event notifications when things happen in PatientPulse.

EventEndpointStatus
payment.completedPOST /webhooks/razorpayActive
sms.incomingPOST /webhooks/twilio/incomingActive
sms.statusPOST /webhooks/twilio/statusActive
claim.status_changeComing soonPlanned
appointment.cancelledComing soonPlanned

Subscription Plans

Starter

Current
Free
  • Sandbox access
  • 10K API calls/month
  • FHIR R4 sandbox
  • Community support

Enterprise

Custom
  • Unlimited API calls
  • Custom SLA
  • Dedicated support
  • On-premise option
  • SAML SSO

Activating a Paid Plan via Razorpay

When you subscribe via Razorpay, PatientPulse reads the subscription's notes object to identify your org and upgrade your plan. You must set these exact fields when creating or linking the Razorpay subscription:

Razorpay Subscription — notes object
{
  "product": "developer_api",     // required — identifies this as a developer API subscription
  "org_id":  "42",              // required — your PatientPulse organisation ID
  "plan":    "growth"           // required — "growth" or "enterprise"
}
1. When subscription.activated or subscription.charged fires, PatientPulse checks notes.product === "developer_api".
2. It upserts a row in organization_subscriptions and sets your org's plan to growth or enterprise.
3. If no live production key exists for your org, one is auto-issued (pp_live_sk_…) and emailed to your billing_email.
4. Find your org ID in Settings → Organisation inside the PatientPulse provider dashboard.

Recent Changelog

2025-11-14
Feature 7B: Pre-consult Summary

Auto-generate patient summaries before doctor consultations + fetch available doctors.

2025-11-12
Feature 7A: FHIR Auto-push

Automatically push FHIR bundles on consult completion via ABDM connector.

2025-11-10
Feature 6: Lab AI Interpretation

POST /ai/interpret-lab-report — structured insights from uploaded lab reports.

2025-11-08
Feature 5: Mobile ABHA Link

New mobile endpoint for ABHA identity linking via ABDM connector.

2025-11-06
Feature 4: Health Connect Sync

Accept and store Android Health Connect payloads (steps, HR, sleep) for patients.