Skip to main content

Creating a new Connector App

For creating a new connector app, press the Add button as shown below

02 Add button

After pressing the Add button the edit view is shown and you can start entering the connector app information.

04 Connector Factory Start Editing

Introducing data to create the Connector App‚Äč

For creating a connector app you need to enter some information about the remote platform you want to access. So the UI will guide you to enter:

  • The connector app name: a lower-case identifier
  • Authorization type: the type of authorization.
  • Authorization data: the parameters needed in the authorization process depending on the kind of authorization
  • Connection data: the connection base URL and the connection parameters and headers
  • Resource Data: For every type of record you want to handle you must enter its name, its primary key and the kind of process you want to conduct: import, export or both.
  • Import Process Data: For every type of record you want to import, you need to enter the webhooks for importing one record and all the records.
  • Export Process Data: For every type of record you want to export, you need to enter the webhooks for creating one new record and updating an existing record.

Let's see, in detail, how to create the connector.

At first you need to enter the connector app name, so a namespace will be generated from that name. Then you need to select the authorization type, and enter the authorization parameters according to the selected type. For example, in case of a basic authorization, you need to enter username and password as shown below

05 Connector Factory Basic Authorization

If you select an Oauth2 Authorization you must enter the header prefix to be used with the access token, the authorization endpoint, the access token endpoint, the client ID, the client secret and the list of comma-separated scopes. The picture below shows the authorization data of a connector app for accessing the Zoho CRM API.

05 Connector Factory Oauth2 Authorization

Then you need to set the connection data. You need to enter the base URL for accessing the API resources and pairs name/value to be used as parameters or headers, if they are needed. The picture below shows the connection data of a connector app for accessing the Zoho CRM API.

06 Connector Factory Connection

After setting the authorization and connection, you must start editing the resources information, so you need to press the Add button in the Resources/Flows section

07 Connector Factory Add Resource Button

For every type of record you want to manage, you need to enter the resources information. For example, in the connector for accessing the Zoho CRM API, we want to manage records of type Contact and Lead. Let's see how to enter that information. After pressing the Add button, a view like the one below is shown and you must enter the data associated with one type of record, then press the Save button and you can repeat the process for every resource you need to add to the connector app.

07a Connector Factory Resource View

At first you need to enter the resource name, the primary key name and the kind of process you want to conduct with that type of record: Import-Flow, Export-Flow or both. As you can see in the example below, a Data Type name will be generated according to the resource name.

08 Connector Factory New Resource Name

Then you need to enter the webhook's details for the import and export process. In case of the import process (if it was selected in the kind of processes) you must set the http method (usually GET) and the resource path for requesting a single record and the http method and resource path for requesting multiple records. The resource path doesn't start nor end with the slash symbol, as shown below

09 Connector Factory New Resource Import Process

In case of the export process (if it was selected in the kind of processes) you must set the http method (usually POST) and the resource path for exporting a new record and the http method (usually PUT) and resource path for exporting an existing record to be updated. The resource path doesn't start nor end with the slash symbol, as shown below

10 Connector Factory New Resource Export Process

The picture above shows the Save button you need to press for finishing editing the resource data. After saving the resource data for the record of type Contact you can see it in the list as shown in the picture below.

11 Connector Factory Add Resource Button

Then you can repeat the process for adding new resources, for example Lead. After the Add button you can enter the resource name, its identifier, and the import process details

12 Connector Factory New Resource Import Process

And if it was selected in the kind of processes, you must enter the details of the export process and press Save.

13 Connector Factory New Resource Export Process and save

After completing the resource data input, you can press the Save button in order to create the connector app as shown below.

13 Connector Factory Save Connector

When the creation process completes, you will be notified in a view like the one in the picture below

14 Connector Factory Completed Notification

Then you can press the Back button

15 Connector Factory Back Button

And you will see the connector app in the list

03 Connector Factory Connector list

Exploring the Connector App‚Äč

Once a connector app is created you can explore its content in the Connector Factory by selecting the connector app and pressing the Details button.

04 Connector Factory Details Button

After pressing the Details button a list of elements is shown. That list contains all the elements generated implicitly by the Connector Factory when the connector app was created.

18 Connector Factory Connector List of Elements

When you explore the list of the connector app elements in the Conector Factory, you are able to select one element and see its details.

19 Connector Factory Connector Element Details Button

That action redirects the user to the show view in Cenit, so, the user will be able to manage that element the same way he can do with any other one in Cenit.

20 Connector Factory Connector Element Details

Since a connector app is a special kind of collection, the connector app can be managed not only from the Connector Factory main view but also from the Collections Menu in Cenit.

21 Connector Factory Collection Created

As you can see in the picture above, a collection has been created in the current tenant and you can manage it as any other collection in Cenit. So, if you select the collection and press the Show button, you can explore its elements directly in the Cenit UI, for example, the webhooks.

22 Connector Factory Collection Details

You get the same result by accessing the menu Gateway/Resource Paths and list the elements in the corresponding namespace.

23 Connector Factory  Resources Paths List in Cenit

After the connector app is created, you might realize you missed to add some resource or some process type for a resource, etc. In those cases, you don't need to start creating the connector app from scratch, you can just press the Resume button to add new resources or edit the existing ones, so you can edit the connector app starting from the previous version and after pressing the Save button, a new collection will be generated for the new version of the connector app.

04 Connector Factory Resume Button

As mentioned before, when a connector app is created in the Connector Factory, a complete set of resources is generated in order to enable the import and export processes of a group of records. The table below contains all the elements implicitly generated in the connector app of the Zoho CRM API that we used as an example.

Element KindElements in the Connector AppObservation
Securitydefault_authorization, default_client, default_providerThe authorization, the authorization client and the authorization provider for getting access to the remote platform.
Connectiondefault_connectionThe connection to the remote platform
Data TypesContact, LeadOne data type for every resource which was added to the connector app.
Data Eventshandle_contact, handle_leadOne data event for every resource which was added to the connector app.
Resources for Contactget_contact, get_contacts, create_contact, update_contactThe webhooks for importing and exporting records of type Contact
Resources for Leadget_lead, get_leads, create_lead, update_leadThe webhooks for importing and exporting records of type Lead
Algorithms for Contactdo_import_contact, do_import_contacts, do_get_contacts, do_get_contact, parse_from_api_response_contacts, trigger_for_change_contact, do_export_contact, do_create_contact, do_update_contact, parse_2_api_request_contactThe algorithms for importing and exporting records of type Contact
Algorithms for Leaddo_import_lead, do_import_leads, do_get_leads, do_get_lead, parse_from_api_response_leads, trigger_for_change_lead, do_export_lead, do_create_lead, do_update_lead, parse_2_api_request_leadThe algorithms for importing and exporting records of type Lead
Algorithmsdo_check_error_response, do_generate_hmacThe algorithm for processing errors in the response and the algorithm for generating the hmac of a record.
Applicationsdefault_appAn application where the incoming webhooks can be defined. Its details are explained in the section understanding_the_incoming_webhooks_elements
Algorithmsaction_hook, action_check_hookThe action algorithms to be used in the incoming webhooks. Their details are explained in the section understanding_the_incoming_webhooks_elements
Algorithm for Contactdo_start_convertersThe algorithm used by the Recipes to find the existing algorithms for mapping a Contact record to records of other Data Types. Its details are explained in the section understanding_the_recipe_elements
Algorithm for Leaddo_start_convertersThe algorithm used by the Recipes to find the existing algorithms for mapping a Lead record to records of other Data Types. Its details are explained in the section understanding_the_recipe_elements