Connect to Data Source

Overview

connect_to_datasource generates an OAuth authorization URL for connecting a patient's account to a selected healthcare data source endpoint (e.g., bluebutton, epic). Call this tool after the user has picked a data source from the results of search_connections, in order to hand them a link that starts the OAuth connection flow.

Required Parameters

endpoint_name (string)

• The name of the data source endpoint to connect to (e.g., bluebutton, epic).
• This is the same value returned as endpoint.name in search_connections results.

Optional Parameters

debug (boolean)

• Default: false
• Whether to include debugging information in the response.

Returns

A string containing the OAuth redirect URL. The user should be directed to this URL to complete the connection to the selected data source.

Notes

connect_to_datasource is typically called immediately after search_connections, using an endpoint_name taken from one of the endpoints in that tool's results.