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:
-
Go to drchrono.com and log into your account.
-
Navigate to Account > API.
-
Click New Application.
-
Fill in the Application Name (e.g., "Keragon DrChrono App").
-
Add the following Redirect URIs:
-
https://api.us-1.keragon.com/rest/auth/callback
-
https://api.us-east-1.keragon.com/rest/auth/callback
-
-
Click Add new to input both redirect URIs.
-
Click Show to reveal and copy the Client ID and Client Secret.
-
Click Save Changes to store the application settings.
-
Go to app.keragon.com, open the DrChrono connector setup.
-
Paste your Client ID and Client Secret into the corresponding fields.
-
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
-
Go to app.keragon.com.
-
Click Add a trigger and choose DrChrono / Trigger.
-
If you don’t have an existing authentication, follow the setup guide above.
-
Enter a custom Secret Token — any value you choose — and Save.
-
Copy the value of the Secret Token.
-
Switch to the DrChrono dashboard and navigate to Account > API.
-
Click Show next to Secret Token and paste the value from Keragon.
-
Go back to Keragon, click the Description tab and copy the Webhook URL.
-
In DrChrono, paste this URL into the Callback URL field.
-
Click Save Changes and then Verify webhook.
-
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
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:
-
After the DrChrono trigger, add a Helpers / Branch action step.
-
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.
-
-
Create additional branches as needed for each event type.
-
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.