OSCAR Connection Errors

If you're having trouble connecting Transcribe Health to your OSCAR EMR instance, or if an existing connection has stopped working, follow these steps.

Connection fails during setup

Check your OSCAR URL - make sure you're entering the full base URL of your OSCAR instance, including the protocol. It should look like https://oscar.yourclinic.ca/oscar (not just oscar.yourclinic.ca).

Check your credentials - OSCAR uses session-based authentication. Make sure you're entering the same username and password you use to log into OSCAR directly. If you recently changed your OSCAR password, update it in Transcribe Health.

Check if OSCAR is accessible - try opening your OSCAR URL directly in a browser. If OSCAR itself is down or unreachable, Transcribe Health won't be able to connect.

Check your network - if your OSCAR instance is hosted on a local network (not cloud-hosted), make sure Transcribe Health can reach it. OSCAR instances behind a firewall without external access cannot be connected unless you set up a secure tunnel.

Connection was working but stopped

OSCAR password changed - if your OSCAR password was changed or expired, the stored credentials are no longer valid. Go to Settings > EHR Integrations and update your credentials.

OSCAR server restarted or updated - after an OSCAR update or server restart, sessions may be invalidated. Disconnect and reconnect the integration.

Network changes - if your OSCAR instance moved to a new URL or IP address, update the connection URL in Settings > EHR Integrations.

Sync errors when pushing notes

Patient not found in OSCAR - if you're trying to push a note but the patient isn't linked to an OSCAR patient record, the push will fail. Go to the patient's profile in Transcribe Health and link them to their OSCAR record first.

Permission denied - your OSCAR user account may not have permission to write encounter notes. Check with your OSCAR administrator that your account has chart write access.

Note format not supported - OSCAR expects encounter notes in a specific format. If you're using a heavily customized document template, some formatting may not transfer cleanly. Try using the default SOAP note template.

Patient mapping issues

Wrong patient linked - if notes are going to the wrong patient's chart in OSCAR, the patient mapping is incorrect. Go to the patient's profile, remove the OSCAR link, and re-link to the correct OSCAR patient record.

Patient not appearing in search - when linking patients, Transcribe Health searches OSCAR by name and demographic number. If the patient's name is spelled differently in OSCAR vs Transcribe Health, the search may not find them. Try searching by demographic number instead.

Getting more help

If you continue to have OSCAR connection issues:

1. Check the OSCAR integration guide for the full setup walkthrough
2. Contact support with your OSCAR version and the specific error message you're seeing