Skip to main content

Client Credentials

The Medplum API uses standard OAuth2/OpenID authentication. The "Client Credentials Flow" is recommended for machine-to-machine access.

Obtaining Credentials

This tutorial assumes you already have a Medplum account. (If not, please register.)

Create a ClientApplication if one does not already exist. You can create a new ClientApplication on the Project Admin page.

For this example you will need the ID and Secret.

Connecting to the service

Execute a HTTP POST request to the OAuth2 Token endpoint:

On success, the response will be a JSON object with the following properties:

"token_type": "Bearer",
"access_token": "<YOUR_AUTH_TOKEN>",
"expires_in": 3600

The value of "access_token" can then be used in future requests for authentication.

For more details about OAuth2 Client Credentials Flow: