Connector Builder

The connector builder is used to create connectors, which are integrations to a specific service (cloud, on-premise) that can be defined in terms of actions and events.

You use the connector builder to create collections of actions and events that are collectively referred to as a connector. You have two distinct environments in the connector builder: the workspace and the control panel. When building a connector, you’ll be using the workspace. Once your connector is finished, you can deploy the finished connector to your organization by using the Control Panel.

At its most basic, you construct connectors in the connector builder by providing the appropriate values to JSON key/value pairs. You can conceptualize these JSON key/value pairs as instructions that define the desired the functionality of the connector. These instructions are executed sequentially, resulting in the build of the connector.

When creating a connector for the first time, the initial JSON required to construct the connector will be generated for you. You can use these generated templates by filling out values to the required keys. Most things inside the connector builder follow this same structure. Modules, authentications, helper functions, and beyond, are just templates that you selectively choose and input value, depending on desired functionality.

For example, when creating a connector that leverages OAuth2 for authentication, JSON will be generated to support that appropriate type of authentication. You will need to supply input values (such as tokens, secrets, authorization paths, etc) to appropriately configure authentication.

Understanding that the connector builder is just executing a series of instructions, instructions that are often generated automatically and then require certain input from you, can help you better conceptualize about how to use the connector builder.

Next up! What is a Connector?