Generate Sso Url
Generate a Single Sign-On URL for DoseSpot Jumpstart integration.
This endpoint creates a signed SSO URL that allows users to seamlessly access DoseSpot from within your application without requiring separate login credentials.
The URL can be used to:
- Launch DoseSpot in a new window/tab
- Embed DoseSpot in an iframe
- Deep link to specific patients or encounters
Args: request: SSO URL generation request containing location_id, user_id and optional parameters session: Database session tenant: Current tenant current_provider: Current authenticated provider
Returns: SSOUrlResponse containing the generated signed SSO URL
Raises: HTTPException: If location_id, user_id is missing or invalid, or location not configured
Headers
The tenant you are making this request on behalf of
Your api key
Body
Request schema for generating DoseSpot SSO URL
Location ID - used to retrieve DoseSpot Clinic ID and Clinic Key
Optional internal patient ID. If provided, patient will be synced to DoseSpot first (if not already synced), then SSO URL will include DoseSpot Patient ID for deep linking
Optional DoseSpot User ID. If not provided, will be looked up from the current provider's dosespot_user_id field
Optional User ID when prescribing on behalf of another provider
Optional Encounter ID to link prescription to specific encounter
Optional Supervisor User ID for supervision workflows
If True, shows refill errors screen
Response
Successful Response
Response schema containing the generated DoseSpot SSO URL
The signed SSO URL to launch DoseSpot