# Setting up live connectors

We need to setup up Live Connectors to access data from sources other than a database, that support API based CRUD operations.

To setup a Live Connector,

1. Login to the **CloudIO** platform. The **CloudIO homepage** is displayed.

![](https://1117313960-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzMJAXNyRSI4WE3Jt4z%2F-M-U8YRYChEcBDa7AQ1F%2F-M-U9qAvgZiX89_Lodr3%2FhomePage.png?alt=media\&token=1b7ddfff-c32a-4411-993c-49c5904aef40)

 2\. In the upper right corner, in the menu bar, click ![](https://1117313960-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzMJAXNyRSI4WE3Jt4z%2F-M-UB4EpaQqpaid4F7nL%2F-M-UBB-CB71eRqi0Vhir%2FAdministrationNavigationMenu.png?alt=media\&token=d71ea766-505b-4810-bf02-6312544ab35d) .

The **Navigation** pane is displayed.

![](https://1117313960-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzMJAXNyRSI4WE3Jt4z%2F-M-U8YRYChEcBDa7AQ1F%2F-M-UA0ChX912W2x1yuBd%2FNavigation%20page.png?alt=media\&token=c0ad2872-dfdd-4471-b2b0-6aab551fead9)

 3\. To setup a live connector, under **Administration**, click **Live Connectors**.

The **Live Connectors** page is displayed.

![](https://1117313960-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzMJAXNyRSI4WE3Jt4z%2F-M-U8YRYChEcBDa7AQ1F%2F-M-UAJDTs2TEiVzbbf6I%2FLiveConnectors.png?alt=media\&token=c722101c-e1dd-47c4-8735-1452ae6a2bec)

 4\. To setup a live connector using predefined service provider like Oracle SaaS or SFDC, open the corresponding service provider and click **Add New Connection**.

The **Setup Connection** widow is displayed. Enter the required connection details

![](https://1117313960-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzMJAXNyRSI4WE3Jt4z%2F-M-U8YRYChEcBDa7AQ1F%2F-M-UA_7IgvIJUaK5VLtz%2FPre-defined%20service.png?alt=media\&token=a040c7af-5d3c-4e1a-a42a-13fba739a793)

 5\. To setup a generic REST service provider, open the generic REST service provider and click **Add New Connection**. 

The **Setup Connection** widow is displayed. Enter the required connection details

![](https://1117313960-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzMJAXNyRSI4WE3Jt4z%2F-M-U8YRYChEcBDa7AQ1F%2F-M-UAegd62kMVvj4B4Fu%2FGeneric%20REST%20service.png?alt=media\&token=d59af543-39bd-4d35-b226-73cff287a7df)

 6\. To complete the configuration, update the describe API in Params JSON along with any other relevant attributes.

![](https://1117313960-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzMJAXNyRSI4WE3Jt4z%2F-M-U8YRYChEcBDa7AQ1F%2F-M-UAvoHGqFj89KWBfpa%2Fupdate%20API.png?alt=media\&token=fb1f63dc-2af2-4d0b-b2d6-d3750dbff660)

 7\. Copy and paste the following JSON excerpt in the **Describe JSON**.

```
{       
    "describe_api": "https://xxx.xx/{service_name}/describe",
    "root_node" : "fields",         
    "display_name": "label",        
    "column_name" :"name",      
    "data_type" : "type",       
     "primary_key" : "Id", 
    "data_length" : "length",                   
    "DOUBLE" : "percent,currency,double,int",       
    "VARCHAR2" : "string,picklist,phone,reference,ID,boolean,url,email,address,collection",          
    "DATE" :"dataTime,date"      
}
```

 8\. To create a connection, click **Submit**.