Getting Started

Up and running with HealthCloud in under 5 minutes. No production credentials required — use a hc_test_sk_demo key to follow along.

01

Get your API key

Sign in to the HealthCloud Developer Console and create an API key under Settings → API Keys.

Keys starting with hc_live_ are for production. Use hc_test_ keys in development — they are free and rate-limited.

Open Developer Console
02

Install an SDK (optional)

Official SDKs are available for Python, JavaScript/TypeScript, and Go. You can also use any HTTP client.

# No installation needed — curl ships with every OS
03

Make your first request

List your organizations to confirm authentication is working.

curl https://api.healthcloud.ai/v1/organizations \
  -H "Authorization: Bearer hc_test_sk_demo"
200 OK200
{
  "data": [
    {
      "id": "org_01hx4f8gj3kqm9n",
      "name": "My Development Org",
      "type": "developer",
      "hipaaCompliant": false,
      "plan": "starter",
      "createdAt": "2026-01-15T08:00:00Z"
    }
  ],
  "meta": { "total": 1, "cursor": null }
}
04

Create a project and install an asset

Projects are isolated workspaces. Create one and install a clinical agent from the marketplace.

curl -X POST https://api.healthcloud.ai/v1/projects \
  -H "Authorization: Bearer hc_test_sk_demo" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My First Project",
    "environment": "staging",
    "fhirVersion": "R4"
  }'

Next Steps

Authentication

Learn about API key scopes and JWT tokens

Agents

Run your first clinical AI agent

Errors

Understand error codes and retry logic

Webhooks

Receive real-time event notifications