You can connect with DrChrono APIs using Postman.
If you haven't set up an API application in your account, refer to Create an API Application. A complete Postman collection of our APIs is at the bottom of this page.
Authorization
If you are using our DrChrono Postman Collection, skip to the Authorization tab from the collection's overview screen. Fill out the configure token section using the table below.
- Before you start, download Postman.
- Open Postman and create a collection. On the left side of the page, select Create Collection.
- Once the collection is created, navigate to the tabs from the collection's overview screen. Select the Authorization tab and then select OAuth 2.0 from the Auth Type dropdown.
- Under the Configure New Token section, fill out the following:
| Field | Description |
|---|---|
| Token Name | This can be anything. For example, Token A |
| Grant type | Leave as is |
| Callback URL | https://oauth.pstmn.io/v1/browser-callback
This should match the Redirect URIs box on the DrChrono API page (Account > API). |
| Auth URL | https://app.drchrono.com/o/authorize/ |
| Access Token URL | https://app.drchrono.com/o/token/ |
| Client ID | From the DrChrono API page |
| Client Secret | From the DrChrono API page |
| Scope | labs:read labs:write messages:read messages:write patients:read patients:write patients:summary:read patients:summary:write settings:read settings:write tasks:read tasks:write user:read user:write billing:patient-payment:read billing:patient-payment:write billing:read billing:write calendar:read calendar:write clinical:read clinical:write |
| State | Leave as is |
| Client Authentication | Leave as is |
- Select Get New Access Token at the bottom of the page.
You'll be redirected to a prompt to sign in to DrChrono, then to another screen to authorize the connection.
- Select Authorize.
Congratulations! You received access and refresh tokens.
- Select Use Token to set the access token to your collection.
First API request
The first call will be to our USERS API endpoint, specifically https://app.drchrono.com/api/users/current. This endpoint provides the connected DrChrono API user.
Alternative configuration
Instead of creating a collection, you can configure a connection at the request level.
- To start, select New or the "+" icon.
- Do one of the following:
- If you selected New, you are prompted to choose a specific method. Select HTTP.
- If you selected the "+" icon, Postman automatically creates a new HTTP request.
- From the new request, navigate to the Authorization tab and configure the new token, and then select Get New Access Token.
Refresh method
This method helps automate the process of grabbing new access tokens. The access token expires in 48 hours. The refresh token does not expire. The refresh token only invalidates if you go through the OAuth process again with the same DrChrono user or use the /o/revoke_token endpoint.
Here is a Python snippet depicting the refresh method.
import requests
url = "https://drchrono.com/o/token/"
payload = 'client_id=1234&client_secret=1234&grant_type=refresh_token&refresh_token=1234'
headers = {
'Content-Type': 'application/x-www-form-urlencoded'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)Let's also take a look at this in Postman. Authorization can be set to No Auth since we are grabbing a new bearer token.
If you have any questions, contact api@drchrono.com
References
- https://app.drchrono.com/api-docs/#section/Introduction
- https://app.drchrono.com/api-docs-old/v4/documentation#orevoke_token
- https://learning.postman.com/docs/getting-started/importing-and-exporting/importing-data/
DrChrono Postman collection
(NEW as of 3/20/25)