Introduction

Integry at a glance

Integry is an integration platform that provides integrations inside your app for your users. You can customize the look and feel of the integrations such that they appear just like your app. For example, your users can connect your app to Slack and send messages to Slack. You can see a list of apps you can embed here.

In order to start building your app, sign in here.

There are three basic steps that will get you up and running with Integry:

1. Create your app connector with Integry
2. Add flows in your app
3. Use the SDK to embed your flows inside your app

Where the SDK comes in

Our SDK embeds flow views within your own application so that you have full control over how you want the embed to look by applying custom styling and branding.

Creating your app connector

This step of the connector creation process requires technical knowledge and some custom configuration. We recommend that someone with a technical background works on this. If you would like us to create your connector for you instead, please get in touch.

App connectors are created under the Connectors tab in your dashboard. Creation of your Integry app connector consists of five major steps which are as follows:

1. Provide basic information

Start by providing basic information about your app

2. Setup your authentication

This will help us authenticate with and consume your API. We support most of the popular authentication types such as OAuth and JWT.

3. Add activities to your connector

An activity can be a trigger, an action or a query.

Trigger

A trigger is an event that takes place in another app. A flow starts with a trigger and ends with one or more actions. For example, If your app is a simple task manager, your triggers can be 'Task Completed', 'Task Created' etc.

Here's a visual representation of how a trigger works:

Action

An action is an event that starts from our platform and takes place in another app. For example, if your app is a task manager, your actions might be 'Create a Task', 'Mark as Completed' and more.

Query

A query is used to import data from one app to another app.

If you don’t have an API created in your app yet, we have created this guide to help you create a basic push API.

4. Create activity endpoints

Triggers or actions act on your API through endpoints. These are URLs where Integry sends a request (action) or receives a request (trigger).

5. Publish your app connector

Once your connector is approved by our team, it is listed in our marketplace. Other developers can create flows with your app. This step marks the end of your app creation and setup process.

Adding Flows

A Flow is a workflow that connects your app to other apps. For example, if your app is a task manager app, a Flow could be 'Send a Slack message when a task is created'.

Flows can be added in the following steps:

1. Create your Flow

Create your templates using the workflow builder. Add everything from the title to actions, triggers, queries, adapters, tools, setup, conditions, schedules, and variables to build powerful integrations with this tool.

2. Add your Flows inside an SDK Deployment

Using Deployments, you can stack together flows that will be visible in the SDK embed inside your app. This way you can serve users with targeted and relevant integrations to use.

Embedding using Integry SDK

Users of your app will create, edit and manage integrations using the SDK. It is designed to be customizable to adapt to the look and feel of your app.

This documentation will help you embed the SDK inside your web app. The following sections contain important information about this process so you can configure a seamless integration.

We hope you are now familiar with how things work at Integry. You are now all set to roll-out your integration. In case of any queries, please contact us via email.

Happy Integrating!