Skip to main content
Your app comes with Supabase and essential integrations pre-configured in draft mode, but you’ll need to create your own Supabase account to make database schema changes. This guide walks through setting up API keys for services you’ll use and how each integration can be setup. You’ll first want to navigate to your project settings tab located in the top left corner of your screen. Then follow the steps below to add your integrations one-by-one.

​
1. Supabase Database Setup

What it’s for: Setup project to store all platform data - patients, appointments, products, and more.
1

Create Account

Go to supabase.com and create a free account
2

Create Project

Click “New Project”, name your project, and set a strong database password (avoid using special characters). Save this password somewhere secure, you’re going to need it later on. Note: Wait 2 minutes after creating your Supabase project before connecting Specode.
3

Get API Keys

Navigate to Settings → API and copy these keys:
  • Project URL → NEXT_PUBLIC_SUPABASE_URL
Supabase project URL
  • anon public → NEXT_PUBLIC_SUPABASE_ANON_KEY
Supabase anon key
  • service_role → SUPABASE_SERVICE_ROLE_KEY
Supabase service role key
  • Database URL
Supabase database URL
Use the Session pooler connection string. Replace [YOUR-PASSWORD] with your actual database password (remove the brackets).
Reset the Supabase database password: If you’ve lost the database password, you can reset it in Supabase Project Settings > Database > Reset database password.
change database password in Supabase

​
2. CometChat Video Integration

What it’s for: Powers HIPAA-compliant video appointments between patients and healthcare providers.
1

Contact CometChat

Contact CometChat to set up a HIPAA-compliant subscription for healthcare use. Or create a free account for testing purposes (no PHI!) at cometchat.com.
2

Get API Keys

Once approved, you’ll receive your credentials from the CometChat dashboard (left-side menu > Application > Credentials):
  • App ID → e.g. 1670574c0951d3ac2
  • Region → us (in lowercase)
  • Auth Key → e.g. 2cfa119703d62ed75774da4e33f9f96f85fdf96f
  • Rest API Key → e.g. 393a5593ceb9b9a638524fedad6f54151fc2019c
3

Configure Integration

Add the CometChat credentials to your Specode project settings.
Supabase database URL
Supabase database URL
HIPAA Compliance Required: Standard CometChat accounts are not HIPAA-compliant. You must specifically request and pay for HIPAA-compliant video calling services before going live with patient video consultations.

​
3. Telegra Integration (Optional)

What it’s for: Provides telehealth and remote monitoring capabilities for healthcare providers.
1

Contact Telegra

Reach out to Telegra for healthcare platform access
2

Get API Keys

Once approved, you’ll receive your credentials:
  • Telegra URL → Telegra_URL
  • API Email → Telegra_API_EMAIL
  • API Password → Telegra_API_PASSWORD
3

Configure Integration

Add all three Telegra credentials to your Specode project settings

​
4. Junction Health Integration (Optional)

What it’s for: Integrates wearable device data and laboratory results for comprehensive patient monitoring.
1

Contact Junction Health

Reach out to Junction Health for healthcare API access
2

Get API Key

Once approved, you’ll receive your credentials:
  • API Key → JUNCTION_API_KEY
3

Configure Integration

Add the Junction Health API key to your Specode project settings

​
5. Stripe Payment Processing

What it’s for: Processes payments for healthcare products, consultations, and subscription services.
1

Create Stripe Account

Go to stripe.com and create a business account
2

Switch to Test Mode

In the Stripe Dashboard, switch to “Test Mode” for development
3

Get API Keys

Navigate to Developers → API Keys and copy:
  • Publishable key → NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY
  • Secret key → STRIPE_SECRET_KEY
4

Configure Webhooks

In Developers → Webhooks, add endpoint: your-domain/api/webhooks/stripe Copy the signing secret → STRIPE_WEBHOOK_SECRET
5

Add to Project Settings

Add all three Stripe credentials to your Specode project settings

​
Adding Custom Services

Need to integrate with other services? You can add custom environment variables for any additional APIs or services.
1

Navigate to Settings

Go to your project settings in the top left corner of your screen
2

Scroll to Bottom

Scroll down to the bottom of the integrations section
3

Click Add Field

Click the “Add Field” button to create new environment variables
4

Configure Variables

Add your custom service credentials:
  • Variable name (e.g., CUSTOM_API_KEY)
  • Variable value (your actual API key or credential)
Some Custom Integration Examples:
  • Electronic Health Record (EHR) systems
  • Laboratory information systems
  • Pharmacy networks
  • Insurance verification services
  • Custom healthcare APIs
Need Additional Help? If you encounter issues during setup, refer to our Troubleshooting Guide or contact your project team for assistance with HIPAA-compliant service configuration.
⌘I