DrChrono

This page contains the setup guide and reference information for the DrChrono connector.

Prerequisites

Before connecting your DrChrono account, ensure that:

  • You have an active DrChrono account.

Setup Guide

Follow these steps to connect your DrChrono account to Keragon:

00:00: This guide will walk you through the steps to create your client ID and Secret 00:04: in doctor Chrono. 00:06: Access the API section under account 00:09: Create a new application. 00:12: Select the application name field 00:15: Still on the aura field 00:18: Select add new 00:21: Add second redirect URL 00:24: Click on show 00:27: Click on show on clients Secret 00:30: Save the changes made and copy client ID and secret and paste 00:34: in carrig on dashboard. 00:37: This guide walks you through finding the client ID and secret on Doctor 00:41: Chrono.

  1. Go to drchrono.com and log into your account.

  2. Navigate to Account > API.

  3. Click New Application.

  4. Fill in the Application Name (e.g., "Keragon DrChrono App").

  5. Add the following Redirect URIs:

    • https://api.us-1.keragon.com/rest/auth/callback

    • https://api.us-east-1.keragon.com/rest/auth/callback

  6. Click Add new to input both redirect URIs.

  7. Click Show to reveal and copy the Client ID and Client Secret.

  8. Click Save Changes to store the application settings.

  9. Go to app.keragon.com, open the DrChrono connector setup.

  10. Paste your Client ID and Client Secret into the corresponding fields.

  11. Click Connect to authorize Keragon via OAuth.

Need more help connecting?

Check the fully extended DrChrono connector setup guide for screenshots, detailed steps, and additional context.

Note: Be sure to copy the Client ID and Secret correctly and configure both redirect URIs for successful authentication.

How-Tos

How to Set Up a DrChrono Webhook Trigger

00:00: This guide will walk you through setting up a caragon webhook in Dr. 00:03: Crono. From adding triggers to verifying webhooks each 00:08: step is detail to ensure a seamless process. 00:15: Click on Dr. Crono 00:18: Navigate to Dr. Chrono Trigger. 00:21: Click an authentication from the list 00:24: Phil secret token with your token 00:27: Click on save to save the changes. 00:30: Copy the secret you fill in secret token input. 00:34: Switch to Dr. Crono dashboard 00:37: Access the API section under account 00:40: Click show next to secret token. 00:43: Paste with value that copied from tarragon dashboard. 00:47: Navigate to app Dot caragon.com. 00:51: Click on description 00:54: Click copy button on webhook URL 00:58: Go to Dr. Chrono dashboard. 01:01: Paste copied webhook URL into callback URL 01:06: Click on Save changes to save the changes. 01:09: Click on verify webhook 01:12: Click on check verification status 01:15: The guide covered setting up a tarragon webhook in Dr. 01:18: Crono including adding triggers navigating through different sections filling 01:22: in necessary information and verifying the webhook.

  1. Go to app.keragon.com.

  2. Click Add a trigger and choose DrChrono / Trigger.

  3. If you don’t have an existing authentication, follow the setup guide above.

  4. Enter a custom Secret Token — any value you choose — and Save.

  5. Copy the value of the Secret Token.

  6. Switch to the DrChrono dashboard and navigate to Account > API.

  7. Click Show next to Secret Token and paste the value from Keragon.

  8. Go back to Keragon, click the Description tab and copy the Webhook URL.

  9. In DrChrono, paste this URL into the Callback URL field.

  10. Click Save Changes and then Verify webhook.

  11. Click Check verification status to confirm the webhook is active.

This setup enables real-time triggering of workflows in Keragon when events occur in DrChrono.

How to Filter Events from DrChrono in a Webhook Trigger

00:00: How to filter events in Dr. Chrono 00:03: Click to add a new action. 00:06: Select the logic table 00:09: Select Branch step 00:12: Click the newly added Branch step in your canvas. 00:16: Click the first branch. 00:19: Rename the branch to something meaningful. 00:25: Add a new condition. 00:28: Click on the first value to select the data from Dr. 00:30: Chrono, that will be evaluated. 00:37: Under headers select the X Factor Chrono event. 00:41: Select or type the second value that will be used for evaluation. 00:49: Save the configuration. 00:52: Add a new Branch if you need to handle additional events. 00:56: Configure the branch to evaluate for other events like patient modify.

DrChrono supports multiple event types through a single webhook. Each event is sent with a header key:

  • Header: X-drchrono-event

To create event-specific workflows:

  1. After the DrChrono trigger, add a Helpers / Branch action step.

  2. Use the X-drchrono-event header to define your branching logic:

    • Click on the "if condition true" logic block.

    • Define conditions based on the expected event values.

  3. Create additional branches as needed for each event type.

  4. Add different actions under each branch to handle specific workflows.

This setup gives you fine-grained control over how each DrChrono event is processed.

Troubleshooting and Common Errors

Error Message Cause Suggested Fix
invalid_client Incorrect Client ID or Secret Verify values from your DrChrono API app configuration and re-enter them.
redirect_uri_mismatch Redirect URIs not properly configured in the API app Ensure both Keragon URIs are entered exactly.
401 Unauthorized OAuth token expired or missing Reconnect the DrChrono account in Keragon.
Webhook verification failed Secret token mismatch or incorrect URL Confirm the Secret Token and Callback URL match what was configured in Keragon.

Limitations and Notes

  • Webhooks require a Secret Token to verify requests between DrChrono and Keragon.

  • DrChrono sends event types via X-drchrono-event headers, allowing conditional logic in Keragon.

  • You must manually verify webhook configuration via the DrChrono dashboard after setup.

Was this article helpful?
0 out of 0 found this helpful

Articles in this section