Skip to main content

Shepherd OpenAPI

Learn more about configuring and using Shepherd's OpenAPI.

Updated over 5 months ago

Please direct any OpenAPI related inquiries to OpenAPI@shepherd.vet for assistance.

Terms & Conditions

Before OpenAPI features can be enabled, you must agree to the applicable terms & conditions. You can review the terms & conditions below in addition to within the application.

OpenAPI usage incurs an added $35 monthly subscription fee.

Enable Connection

To begin using Shepherd's OpenAPI, you'll first need to enable OpenAPI. Navigate to Admin -> Integrations -> OpenAPI to access the activation setting toggle.

Multi-Location Setting Management

For group accounts, OpenAPI access for clinic level usage must first be granted from the Multi-Location platform. The related setting, Enable Clinic Connections, can be found by following: Settings -> General while on the Multi-Location platform. Don't forget to save your election! OpenAPI access can be updated from the Multi-Location platform at any time.

Creating and Managing API Key Sets

Once Shepherd OpenAPI is enabled, you will see a new section for Key Sets appear. Here you can create new API key sets or manage existing sets.

Creating New Key Sets

To create a new key set select Add New Set within the grey canvas area along the left side. You'll be required to define a Set Name. When a new key set is created, you'll have full visibility to the private key. The private key will not be fully visible after initial creation. It is recommend you copy the private key and transfer it to your external connection configuration. When ready, select Save.

Enabling Key Sets

To enable a key set, ensure the toggle at the end of the key set row is toggled on.

Disabling Key Sets

To disable a key set, ensure the toggle at the end of the key set row is toggled off.

Accessing the Private Key

The private key of a key set is fully visible only when created or when refreshed for a new key. Select the Refresh Key button to generate a new private key.

Did this answer your question?