---
title: "How to: Create Connections and Recipes Using the Integration Gateway"
slug: "how-to-create-connections-and-recipes-using-the-integration-gateway"
updated: 2025-09-25T19:51:32Z
published: 2025-09-25T19:51:32Z
canonical: "docs.unqork.io/how-to-create-connections-and-recipes-using-the-integration-gateway"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unqork.io/llms.txt
> Use this file to discover all available pages before exploring further.

# How to: Create Connections and Recipes Using the Integration Gateway

## Overview

The Integration Gateway lets you integrate with over 700 systems across enterprise [applications](/v1/docs/introduction-to-unqork-applications), databases, and legacy on-premise infrastructure—in the cloud or on-premise. To take advantage of these integrations, it requires **creating connections and recipes**, activating them, and using a [Plug-In](/v1/docs/plug-in-component) component to run them. This how-to guide teaches you how to create connections and recipes and run your integrations.

> To learn how to access the Integration Gateway, view our [Integration Administration](/v1/docs/adm-intro-integration-administration) article.

## Creating an Integration Using Integration Gateway

A few steps are involved when creating connections and recipes and running them:

1. **Create a connection**: First, you must connect to your external service to make any API calls using Unqork. This process requires an account and authorization credentials for that service.
2. **Create a recipe**: Recipes are workflow-like steps that perform actions. Recipes have many advanced features that can handle all application integrations and workflow automation scenarios, including conditional triggers, actions, and so on.
3. **Define an endpoint for a recipe**: To make an API call to an external service in your Unqork [applications](/v1/docs/introduction-to-administration), you must establish an endpoint. You'll use this endpoint to make the call in a [Plug-In](/v1/docs/plug-in-component) component.
4. **Configure a Plug-In component**: Set up a [Plug-In](/v1/docs/plug-in-component) component to call your recipe's endpoint and perform the recipe's actions.

### Creating a Connection

You must have accounts to all your external systems to create connections. For example, if you connect to Salesforce, you're prompted to log into your Salesforce account to complete the connection. After confirming your credentials, you can use the connection in a recipe to set up the integration.

To create a connection:

1. Open your Integration Gateway project.
2. Click **Create ▾**.
3. Select ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Connection_Icon.png?sv=2026-02-06&spr=https&st=2026-11-08T03%3A56%3A53Z&se=2026-11-08T04%3A56%3A53Z&sr=c&sp=r&sig=Sc%2FkgXaQ1Ob2O4wSEgYh1nq34pCZj35BuLyk777RBk4%3D) **Connection**.
4. Search for or select the supported connection you want to use.
5. In the **Connection Name******* field, enter a name for your connection.

> [!TIP]
> It's a best practice to create a name that clearly defines the connection's purpose.
6. From the **Auth Type******* drop-down, select an authentication type.

> [!NOTE]
> By default, OAuth 2.0 is selected.
7. From the **Sandbox** drop-down, determine if you want to set up this connection in a non-production sandbox.

> [!TIP]
> Setting up a connection in a sandbox lets you test the connection without altering the live data.
8. Complete the remaining fields to authenticate the connection. These fields are specific to the external service.

> [!TIP]
> If you are unsure how to configure the remaining fields, visit that external service's documentation.
9. Click **Connect**.

Below is an example of a configured connection:

[![A static image displaying a configured connection.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntAdmin_Connection_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-08T03%3A56%3A53Z&se=2026-11-08T04%3A56%3A53Z&sr=c&sp=r&sig=Sc%2FkgXaQ1Ob2O4wSEgYh1nq34pCZj35BuLyk777RBk4%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntAdmin%20Connection.jpg?sv=2026-02-06&spr=https&st=2026-11-08T03%3A56%3A53Z&se=2026-11-08T04%3A56%3A53Z&sr=c&sp=r&sig=Sc%2FkgXaQ1Ob2O4wSEgYh1nq34pCZj35BuLyk777RBk4%3D)

### Creating a Recipe

With your connection set up, you can now build a recipe. A recipe works like an Unqork [Workflow](//docs/introduction-to-workflow). You'll create a starting and ending point with steps in between. Recipes let you integrate your connections, set up triggers, and determine the actions and events you want to trigger.

### Setting a Starting Point

To create a recipe:

1. Open your Integration Gateway project.
2. Click **Create ▾**.
3. Select ![Icon](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/recipe.png?sv=2026-02-06&spr=https&st=2026-11-08T03%3A56%3A53Z&se=2026-11-08T04%3A56%3A53Z&sr=c&sp=r&sig=Sc%2FkgXaQ1Ob2O4wSEgYh1nq34pCZj35BuLyk777RBk4%3D) Recipe.
4. In the **Name** field, enter a name for your recipe.
5. From the **Pick a Starting Point******* section, select ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Endpoint_Icon.png?sv=2026-02-06&spr=https&st=2026-11-08T03%3A56%3A53Z&se=2026-11-08T04%3A56%3A53Z&sr=c&sp=r&sig=Sc%2FkgXaQ1Ob2O4wSEgYh1nq34pCZj35BuLyk777RBk4%3D) **Build an API Endpoint**.

> [!WARNING]
> You must create an API endpoint recipe or the integration will not be available in Unqork.
6. Click **Start Building**.

Below is an example of a configured starting point:

[![A static image displaying a configured recipe starting point.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntAdmin_Recipe_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-08T03%3A56%3A53Z&se=2026-11-08T04%3A56%3A53Z&sr=c&sp=r&sig=Sc%2FkgXaQ1Ob2O4wSEgYh1nq34pCZj35BuLyk777RBk4%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntAdmin%20Recipe.jpg?sv=2026-02-06&spr=https&st=2026-11-08T03%3A56%3A53Z&se=2026-11-08T04%3A56%3A53Z&sr=c&sp=r&sig=Sc%2FkgXaQ1Ob2O4wSEgYh1nq34pCZj35BuLyk777RBk4%3D)

#### Configuring Actions

With the starting point set, you can create actions and link them to the connections. Actions are recipe steps that let you create, update, and search for data in a target application.

Using the ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Action_Plus_Icon.png?sv=2026-02-06&spr=https&st=2026-11-08T03%3A56%3A53Z&se=2026-11-08T04%3A56%3A53Z&sr=c&sp=r&sig=Sc%2FkgXaQ1Ob2O4wSEgYh1nq34pCZj35BuLyk777RBk4%3D) button, you can add multiple actions, connecting them to your connection and Unqork. When your recipe is complete, click **Save**. Then, click **Test Recipe** to confirm it works correctly. Recipe actions include:

#### Action in an App

Performs a specific action in an application.

#### Call Function

These actions are called recipe functions. They let you call another recipe so you can reuse recipe logic.

#### IF Condition

Performs an action when criteria are met and another action when not.

#### IF/ELSE Condition

Performs a different action if the specified criteria are not met.

#### Handle Errors

Lets you monitor for errors, make another job attempt, or notify a user.

#### Repeat Action

Performs the same action on each item of a list.

#### Stop Job

Stops a job from processing. You can use this action to define a failed or successful job and end it

#### Starting the Recipe

Before you leave your recipe, you must run it.

To start your recipe:

1. At the top of the Recipe Builder panel, click **Save**.
2. At the top right of the Recipe Builder panel, click **x Exit**.
3. Click **Start Recipe**.

Below is an image of a configured and running recipe:

[![A static image displaying a configured recipe.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntAdmin_Recipe_02_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-08T03%3A56%3A53Z&se=2026-11-08T04%3A56%3A53Z&sr=c&sp=r&sig=Sc%2FkgXaQ1Ob2O4wSEgYh1nq34pCZj35BuLyk777RBk4%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntAdmin%20Recipe%2002.jpg?sv=2026-02-06&spr=https&st=2026-11-08T03%3A56%3A53Z&se=2026-11-08T04%3A56%3A53Z&sr=c&sp=r&sig=Sc%2FkgXaQ1Ob2O4wSEgYh1nq34pCZj35BuLyk777RBk4%3D)

Your recipe is now running and ready for use in Unqork. The final step is to create an endpoint for your recipe.

### Creating an Endpoint

Next, you must create a usable endpoint for your recipe. Doing so lets you use a [Plug-In](/v1/docs/plug-in-component) component to run the recipe. You'll define your endpoint's path and HTTP method, set up timeouts, and determine how long the response is stored in the cache. Use the **API Platform** tab in the Integration Gateway to set up your endpoint.

To configure your endpoint:

1. At the top of the Recipe Builder, click the **API Platform** tab.
2. From the **API Collections** panel, select the **Unqork Gateway** collection tile.
3. Click **+ New Endpoint**. A modal displays to configure your new endpoint.
4. In the **Endpoint Name******* field, enter a name for this endpoint.

> [!TIP]
> It's a best practice to create a name that defines your endpoint.
5. From the **Recipe******* drop-down, select your recipe.
6. In the **Endpoint Path******* field, enter a unique path for your endpoint. For example, `createSalesforceContact`.
7. From the **HTTP Method******* drop-down, select the method for this endpoint.
8. Click **Add Endpoint**. You return to the API Platform page.

Below is an example of a configured endpoint:

[![A static image displaying a configured endpoint.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntAdmin_Endpoint_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-08T03%3A56%3A53Z&se=2026-11-08T04%3A56%3A53Z&sr=c&sp=r&sig=Sc%2FkgXaQ1Ob2O4wSEgYh1nq34pCZj35BuLyk777RBk4%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntAdmin%20Endpoint.jpg?sv=2026-02-06&spr=https&st=2026-11-08T03%3A56%3A53Z&se=2026-11-08T04%3A56%3A53Z&sr=c&sp=r&sig=Sc%2FkgXaQ1Ob2O4wSEgYh1nq34pCZj35BuLyk777RBk4%3D)

Before you can configure your API call in a Plug-In component, you must activate your endpoint. On your endpoint tile, set the **Active** toggle to ![A toggle switch indicating an on/off state for a user interface element.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Group 1.png?sv=2026-02-06&spr=https&st=2026-11-08T03%3A56%3A53Z&se=2026-11-08T04%3A56%3A53Z&sr=c&sp=r&sig=Sc%2FkgXaQ1Ob2O4wSEgYh1nq34pCZj35BuLyk777RBk4%3D) **(ON)**. You can now select the endpoint in a Plug-In component.

[![A static image displaying the activated endpoint.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntAdmin_Active_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-08T03%3A56%3A53Z&se=2026-11-08T04%3A56%3A53Z&sr=c&sp=r&sig=Sc%2FkgXaQ1Ob2O4wSEgYh1nq34pCZj35BuLyk777RBk4%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntAdmin%20Active.jpg?sv=2026-02-06&spr=https&st=2026-11-08T03%3A56%3A53Z&se=2026-11-08T04%3A56%3A53Z&sr=c&sp=r&sig=Sc%2FkgXaQ1Ob2O4wSEgYh1nq34pCZj35BuLyk777RBk4%3D)

### Configuring a Plug-In Component

The final step is to configure your endpoint in a [Plug-In](/v1/docs/plug-in-component) component. These instructions assume that you have an open module saved with a title.

1. In the Module Builder, drag and drop a Plug-In component onto your canvas.
2. In the Property ID and Canvas Label Text fields, enter values that describe your Plug-In component.
3. To the left of the component's configuration window, click **D****ata**.
4. Set **External** as the **Service Type**.
5. From the **External Services** drop-down, select the endpoint you created.

> [!NOTE]
> On selection, the Data Source URL and Request Type automatically populate.
6. In the **Inputs** table, configure the specific fields you want.
7. Click **Save & Close**.
8. **Save** your module.

Below is an example of a configured Plug-In component:

[![A static image displaying a configured Plug-In component with an Integration Gateway endpoint selected as the External Service.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntAdmin_PlugIn_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-08T03%3A56%3A53Z&se=2026-11-08T04%3A56%3A53Z&sr=c&sp=r&sig=Sc%2FkgXaQ1Ob2O4wSEgYh1nq34pCZj35BuLyk777RBk4%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntAdmin%20PlugIn.jpg?sv=2026-02-06&spr=https&st=2026-11-08T03%3A56%3A53Z&se=2026-11-08T04%3A56%3A53Z&sr=c&sp=r&sig=Sc%2FkgXaQ1Ob2O4wSEgYh1nq34pCZj35BuLyk777RBk4%3D)

## Resources

- [Learn more about APIs.](/v1/docs/apis-connecting-your-apps)
- [Learn how APIs work](/v1/docs/how-do-apis-work).
- [Integration Administration](/v1/docs/adm-intro-integration-administration).
- [How to: Create On-Prem Groups Using the Integration Gateway](/v1/docs/how-to-create-on-prem-agents-using-the-integration-gateway).
- [How to: Promote Recipes Using the Integration Gateway](/v1/docs/how-to-promote-recipes-using-the-integration-gateway).
- [How to: Get Salesforce Contact Records](/v1/docs/how-to-get-salesforce-contact-records).
- [How to: Create Salesforce Contact Records](/v1/docs/how-to-create-salesforce-contact-records).

APIs (application programming interfaces) are a set of protocols and definitions developers use to build and integrate application software. APIs act as the connective tissue between products and services.

A modal is a window that appears on top of the content you are currently viewing.

A Property ID is the unique field ID used by Unqork to track and link components in your module.

Canvas Label Text indicates the purpose of the corresponding field or component. For non-input components, the Canvas Label Text isn't end-user facing, and only appears in the .