The Novamed Integrations API is a set of HTTP endpoints that help your app integrate with Novamed.
\nBase URL
\nDevelopment - https://novamed-feapidev.stackmod.info
\nProduction - https://feapi.novamed.care
\nAll API access is over HTTPS. All data is sent and received as JSON.
\nPlease note that all requests require at least these two headers:
\nContent-Type: application/json
\nAccept: application/json
\nThe following table describes all the possible HTTP error codes.
\njson
\n{\n \"success\": false,\n \"error\": {\n \"message\": \"string\",\n \"details\": {}\n }\n}\n\nWe will provide an API Key and Clinic Id. All requests needs to pass a header x-api-key with the provided value. Clinic Id needs to pass the body / request if it is required by the endpoint.
Creates a new practitioner (doctor or veterinarian) in the system. This endpoint is used to onboard practitioners by collecting their personal, professional, and contact information. All required fields must be provided and must pass validation.
\nMethod: POST
\nURL: /api/external/practitioner
Send a JSON object with the following fields:
\nAll required fields must be provided and valid.
\nassigned_clinic must reference an existing clinic UUID.
Validation errors will return descriptive messages for each field.
\nCreate a new patient record in the system. This endpoint is used to register a human or animal patient, along with their contact and address details. The request body must conform to the schema and validation rules described below.
\nMethod: POST
\nURL: /api/external/patient
Send a JSON object with the following fields:
\naddressLine1 (string, required): First line of address.
addressLine2 (string, required): Second line of address.
addressLine3 (string, optional): Third line of address.
city (string, required): City name.
state (string, required): State code (Eg: NY, TX).
postalCode (string, required): Postal code.
phone: Must be a valid US phone number (+1XXXXXXXXXX, 1XXXXXXXXXX, or XXXXXXXXXX).
email: Must be a valid email address.
\nurl: Must be a valid URL.
\nAll required fields must be present and valid.
\nOnly one address object is allowed in the addresses array.
For detailed validation rules, refer to the schema.
\nThis endpoint allows you to create a new medication order for a patient. It is used by clinics or practitioners to initiate a prescription and shipment workflow for compounded or standard medications.
\nMethod: POST
\nURL: /api/external/medication-order
The request body must be a JSON object with the following structure:
\nUse the notes field to communicate important information such as allergies or special handling instructions.
Set is_refrigerated to true if the medication requires cold storage during shipping.
Ensure all referenced IDs (patient, practitioner, clinic) exist in the system before submitting the request.
\nAll required fields must be provided. If a required field is missing, a descriptive error message will be returned (e.g., Patient Id is required).
delivery_speed must be either next-day or business-day.
quantity can be a string or integer.
Creates a new refill request for an existing medication request.
\nMethod: POST
\nURL: /api/external/refill-request
medication_request_id is required and must be a valid UUID.
shipment_group_id is optional.
All error messages are returned in the response body as JSON.
\nThis endpoint allows you to register a new webhook for clinic which was assigned to you. Once registered, the system will send event notifications to the provided webhook URL whenever relevant events occur for the specified clinic.
\nMethod: POST
\nURL: {{baseUrl}}/api/external/webhook
Send a JSON object in the request body with the following fields:
\n","urlObject":{"path":["api","external","webhook"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"4fb6a58c-9445-434f-a745-414dc68ec7bb","name":"Create new webhook","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"clinic_id\": \"550e8400-e29b-41d4-a716-446655440001\",\n \"webhook_url\": \"https://webhook.site/123e4567-e89b-12d3-a456-426614174000\"\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/api/external/webhook"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 13 Oct 2025 09:19:20 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Content-Length","value":"118"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"success\": true,\n \"data\": {\n \"webhook_id\": \"550e8400-e29b-41d4-a716-446655440001\"\n },\n \"message\": \"Webhook created successfully\"\n}"}],"_postman_id":"c9ba58f6-f14b-4a73-8488-7c461876fcc8"},{"name":"Delete a webhook","id":"8dfe7bb8-5e1a-49fc-8ad0-f649b5dfeee2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":"{{APIKey}}"}]},"isInherited":false},"method":"DELETE","header":[],"url":"{{baseUrl}}/api/external/webhook/:id","description":"Deletes an existing webhook by its unique ID. Use this endpoint to remove a webhook from the system so it no longer receives event notifications. The id path variable must be set to the webhook's identifier.
\nMethod: DELETE
\nURL: /api/external/webhook/:id
Path Variables:
\nid (string, required): The unique identifier of the webhook to delete.None
\n","urlObject":{"path":["api","external","webhook",":id"],"host":["{{baseUrl}}"],"query":[],"variable":[{"type":"any","value":"550e8400-e29b-41d4-a716-446655440001","key":"id"}]}},"response":[{"id":"53b9fe90-d5e3-43b8-bccd-075c33d1ac69","name":"Delete a webhook","originalRequest":{"method":"DELETE","header":[],"url":{"raw":"{{baseUrl}}/api/external/webhook/:id","host":["{{baseUrl}}"],"path":["api","external","webhook",":id"],"variable":[{"key":"id","value":"550e8400-e29b-41d4-a716-446655440001"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 13 Oct 2025 09:23:15 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Content-Length","value":"57"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Webhook deleted successfully\"\n}"}],"_postman_id":"8dfe7bb8-5e1a-49fc-8ad0-f649b5dfeee2"}],"id":"ef6fcd0b-ef68-4d61-8cb1-62bdf9f79d28","_postman_id":"ef6fcd0b-ef68-4d61-8cb1-62bdf9f79d28","description":""}]}