FAQ

Do I need to send an organization identifier in the request body?

No. The organization is automatically determined from your API key.

Can I send a single appointment instead of an array?

Yes. You can send a single object with an appointment key at the top level without wrapping it in an appointments array. It will be processed as a single-item batch.

What happens if I send a status you don’t recognize?

It defaults to booked. Contact Insight Health to add new statuses if needed. See Status Reference for the full list.

What date/time format should I use?

MM/DD/YYYY for dates and MM/DD/YYYY HH:MM for datetimes. Times should be in the clinic’s local timezone.

How quickly do you process appointments?

Appointments are processed asynchronously and are typically available in the Insight Health platform within seconds.

What if my endpoint is down when you push a note?

We log the failure and may retry. Contact Insight Health to discuss retry policies and dead-letter queue options for your integration.

Can I use the same API key for multiple EHR endpoints?

No. Each API key is bound to a specific EHR identifier and organization. If you operate multiple EHRs, you will receive separate credentials for each.

How do I test in staging?

Use the staging base URL (https://integrations.api.lumi.build) with your staging credentials. The API behavior is identical to production.