{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":21364,"path":"integrate-applications/integration-hub/redox-setup.md","title":"Set up the Redox Electronic Health Record Spoke","bundle":null,"doc_type":null,"release":"australia","body":"\n# Set up the Redox Electronic Health Record Spoke\n\nIntegrate your ServiceNow instance and the Redox engine with both inbound and outbound configuration.\n\n## Before you begin\n\n**Important:**\n\nStarting with the Yokohama release, Redox Electronic Health Record Spoke is being prepared for future deprecation. It will be hidden and no longer activated on new instances but will continue to be supported.\n\nFor details, see the [Deprecation Process \\[KB0867184\\]](https://support.servicenow.com/kb_view.do?sysparm_article=KB0867184) article in the Now Support knowledge base.\n\n- Request an Integration Hub subscription.\n- Ensure you have the admin access to the Redox engine dashboard [https://dashboard.redoxengine.com/\\#/login](https://dashboard.redoxengine.com/#/login).\n- Activate the Redox Electronic Health Record Spoke.\n- Role required: admin.\n\n## About this task\n\nThis task gives the procedure to set up both the inbound and outbound transactions between your ServiceNow instance and the Redox engine. After you configure the inbound transactions, the Redox engine can make calls to the ServiceNow REST Application Programming Interface \\(API\\). The outbound setup enables the ServiceNow instance to get authenticated and connect with the Redox engine.\n\n## Procedure\n\n1. [Create a Redox Electronic Health Record Spoke connection and credential record](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/redox-setup.md).\n\n This procedure enables the outbound transactions.\n\n2. [Configure the external Redox healthcare system as a source system for the Redox Electronic Health Record Spoke](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/redox-setup.md).\n\n This procedure enables the inbound transactions.\n\n\n## Create a Redox Electronic Health Record Spoke connection and credential record\n\nEnable your ServiceNow instance to connect with the Redox engine by setting up a connection and credential record.\n\n### Before you begin\n\n**Important:**\n\nStarting with the Yokohama release, Redox Electronic Health Record Spoke is being prepared for future deprecation. It will be hidden and no longer activated on new instances but will continue to be supported.\n\nFor details, see the [Deprecation Process \\[KB0867184\\]](https://support.servicenow.com/kb_view.do?sysparm_article=KB0867184) article in the Now Support knowledge base.\n\nRole required: admin\n\n### Procedure\n\n1. Log in to your ServiceNow instance.\n\n2. Navigate to **All** > **Process Automation** > **Flow Designer**.\n\n3. On the Flow Designer page, select Connections.\n\n4. In the Search all connections field, enter `Redox`.\\[Omitted image \"redox-spoke-search-redox.png\"\\] Alt text: Enter Redox spoke name in search field.\n\n5. On the Redox Electronic Health Record Spoke card, click **View Details**.\n\n6. Click **Configure**.\\[Omitted image \"redox-configure-button.png\"\\] Alt text: Redox connection and credential configure button.\n\n7. In the Configure Connection form, fill details.\n\n\n
\n\nField\n\n\n\nDescription\n\n
\n\nConnection Name\n\n\n\nName of the connection.**Note:** If you're creating the first record, then Redox Electronic Health Record Spoke is the default name and it's read-only. If you create any record after that, you can provide custom connection name.\n\n
\n\nConnection URL\n\n\n\nThe URL to connect to the Redox engine. Enter [https://api.redoxengine.com/](https://api.redoxengine.com/).\n\n
\n\nName\n\n\n\nName of the Redox Electronic Health Record Spoke credential. The default name is Redox credential but you can update it.\n\n
\n\nAPI Key\n\n\n\nThe API key to access the Redox engine dashboard. You must generate the key on the Redox engine dashboard [https://dashboard.redoxengine.com/\\#/login](https://dashboard.redoxengine.com/#/login). **Tip:** To learn how to generate the API key, see the Redox developer documentation.\n\n
\n\nSecret\n\n\n\nThe source secret to access the Redox engine dashboard. You must generate the secret on the Redox engine dashboard [https://dashboard.redoxengine.com/\\#/login](https://dashboard.redoxengine.com/#/login). **Tip:** To learn how to generate the secret, see the Redox developer documentation.\n\n
8. Click **Configure Connection**.\n\n The connection and credential record is created.\n\n9. Click **View connection alias**.\\[Omitted image \"redox-spoke-click-connection-alias.png\"\\] Alt text: View connection alias button on Redox spoke record.\n\n10. In the **Credential** column, select **Redox Credential**.\\[Omitted image \"redox-spoke-click-creds.png\"\\] Alt text: Credential column value in the Connections tab.\n\n11. On the Redox credential page, click **Get Token** to generate a token for raising authenticated requests from the spoke actions.\n\n\n## Configure the external Redox healthcare system as a source system for the Redox Electronic Health Record Spoke\n\nEnable the Redox Electronic Health Record Spoke to send data to the external Redox healthcare system by configuring the source and destination IDs of the system in your ServiceNow instance.\n\n### Before you begin\n\n**Important:**\n\nStarting with the Yokohama release, Redox Electronic Health Record Spoke is being prepared for future deprecation. It will be hidden and no longer activated on new instances but will continue to be supported.\n\nFor details, see the [Deprecation Process \\[KB0867184\\]](https://support.servicenow.com/kb_view.do?sysparm_article=KB0867184) article in the Now Support knowledge base.\n\nRole required: admin\n\n### Procedure\n\n- Configure the Source system \\[sn\\_hcls\\_source\\_system\\] table to send data to an external Redox healthcare system by using the Redox Inbound Integration application.\n\n For more information, see [Configure an external Redox healthcare system as a source system for a custom integration](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/healthcare-life-sciences/hcls-config-source-system.md).\n\n- Specify the destination ID used in the Source system \\[sn\\_hcls\\_source\\_system\\] table for each spoke action in your flow.\n\n\n"}}