---
title: "How to: Promote Recipes Using the Integration Gateway"
slug: "how-to-promote-recipes-using-the-integration-gateway"
updated: 2025-09-25T19:42:22Z
published: 2025-09-25T19:42:22Z
canonical: "docs.unqork.io/how-to-promote-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: Promote 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. After creating recipes in your non-production environment levels, you can promote them to Production. Following this promotion process lets you develop more efficiently and ensures your integrations work correctly in all your environment levels.

> [!TIP]
> To learn more about Unqork environment levels and promotion stages, view our [Unqork Promotions Order](/v1/docs/unqork-promotions-order) article.

This process involves setting up your recipe package, or manifest, in a non-production environment level and downloading it to your computer. Then, you'll access your Production environment level and upload it. It's important to note that you do not have to promote your recipes and connections at every Unqork environment level. If you create your manifest in any non-production environment (Staging, QA, or UAT), it's available in the other non-production environment levels. So, you only need to promote your manifest to your Production environment.

> [!WARNING]
> For Creators with a Pre-Production environment level, the Integration Gateway considers it to be a production environment level. If you promote your manifest to your Production environment level, it's also available in your Pre-Production environment level.

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

## What You'll Learn

In this article, you'll learn how to export your existing recipes from one environment level and import them to another.

## Exporting a Manifest

After accessing the Integration Gateway, you'll use the **Promote** tab to create a recipe package that you can export from your non-production environment levels. When you navigate to this section of the Integration Gateway, the default view is the **Export** tab. From this tab, you can create an export manifest or view and select an existing one.

[![A static image displaying the selection of the Promote tab in the Integrations Gateway.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway_Promote_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A53%3A04Z&se=2026-11-09T04%3A53%3A04Z&sr=c&sp=r&sig=JADJOWZrfi4QEJLFVwu76bI4k%2B%2F3Oapdia%2BqbKIdiKQ%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway%20Promote.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A53%3A04Z&se=2026-11-09T04%3A53%3A04Z&sr=c&sp=r&sig=JADJOWZrfi4QEJLFVwu76bI4k%2B%2F3Oapdia%2BqbKIdiKQ%3D)

### Creating an Export Manifest

The first step is to create an export manifest using the **Export** tab. You'll select the folder storing all your recipe and connection assets and include it in the manifest.

To create an export manifest:

1. Navigate to the **Promote** tab.
2. Click **New Manifest**.
3. In the **Manifest Name*** field, enter a name for your manifest.
4. From the **Source Folder*** menu, select the project folder whose assets you want to include.

[![A static image displaying the Create Manifest modal where you enter a manifest name and select a folder to whose assets you can include in it.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway_Manifest_01_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A53%3A04Z&se=2026-11-09T04%3A53%3A04Z&sr=c&sp=r&sig=JADJOWZrfi4QEJLFVwu76bI4k%2B%2F3Oapdia%2BqbKIdiKQ%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway%20Manifest%2001.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A53%3A04Z&se=2026-11-09T04%3A53%3A04Z&sr=c&sp=r&sig=JADJOWZrfi4QEJLFVwu76bI4k%2B%2F3Oapdia%2BqbKIdiKQ%3D)
5. Click **Next**.
6. Select all assets you want to include in the manifest. You can also choose to select test cases created when testing your recipe.

> [!NOTE]
> By default, all assets are selected. Deselect those you want to exclude from the manifest.

[![A static image displaying the Create Manifest modal where you can select the assets you want included in the manifest.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway_Manifest_02_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A53%3A04Z&se=2026-11-09T04%3A53%3A04Z&sr=c&sp=r&sig=JADJOWZrfi4QEJLFVwu76bI4k%2B%2F3Oapdia%2BqbKIdiKQ%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway%20Manifest%2002.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A53%3A04Z&se=2026-11-09T04%3A53%3A04Z&sr=c&sp=r&sig=JADJOWZrfi4QEJLFVwu76bI4k%2B%2F3Oapdia%2BqbKIdiKQ%3D)
7. Click **Create Manifest**. The details of your export manifest display.

### Viewing the Export Manifest Details

After creating or accessing an existing manifest, you can view its details and take various actions on the manifest.

[![A static image displaying the Manifest Details and the actions you can take on a manifest.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway_Manifest_Details_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A53%3A04Z&se=2026-11-09T04%3A53%3A04Z&sr=c&sp=r&sig=JADJOWZrfi4QEJLFVwu76bI4k%2B%2F3Oapdia%2BqbKIdiKQ%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway%20Manifest%20Details.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A53%3A04Z&se=2026-11-09T04%3A53%3A04Z&sr=c&sp=r&sig=JADJOWZrfi4QEJLFVwu76bI4k%2B%2F3Oapdia%2BqbKIdiKQ%3D)

|  | Attribute | Description |
| --- | --- | --- |
| 1 | **Manifest Content** | This tab displays the assets contained in the manifest. |
| 2 | **Export History** | ![A static image displaying the Export History tab where you can see previous builds and download them.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway_Export_History.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A53%3A04Z&se=2026-11-09T04%3A53%3A04Z&sr=c&sp=r&sig=JADJOWZrfi4QEJLFVwu76bI4k%2B%2F3Oapdia%2BqbKIdiKQ%3D) Every time you build a manifest package, it stores in Export History. Use this tab to view all the built packages and when they were built. You can also download the packages as a ZIP file onto your computer. |
| 3 | **Build and Export Package** | Lets you build a manifest package and download it as a ZIP file onto your computer. All builds display in the Export History tab. |
| 4 | ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/edit_teal_icon(2).png?sv=2026-02-06&spr=https&st=2026-11-09T03%3A53%3A04Z&se=2026-11-09T04%3A53%3A04Z&sr=c&sp=r&sig=JADJOWZrfi4QEJLFVwu76bI4k%2B%2F3Oapdia%2BqbKIdiKQ%3D) **Edit Manifest** | Lets you update the manifest's assets. After making your changes, click **Update Manifest**. |
| 5 | **Source Folder** | The folder and subfolders added to the manifest. |
| 6 | **Your Manifest Contains** | The recipes and connections included in the manifest. |
| 7 | **Latest Activity** | The date and time the manifest was created or modified. |

### Building and Exporting a Manifest

The final step of the exporting process is to build and export your manifest. The Integration Gateway builds your manifest as a **ZIP** file so you can download it onto your computer. Then, you'll import that file for use in your Production environment level.

To build and export your manifest:

1. Access your export manifest from the Integration Gateway's **Export** tab.
2. At the top right, click **Build and Export Package**.
3. Click **Download**. Your file is now available in your computer's downloads folder with the file name of {manifest-name}-unqork-qa-nonprod.zip.

[Video](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway_Build_Export.webm?sv=2026-02-06&spr=https&st=2026-11-09T03%3A53%3A04Z&se=2026-11-09T04%3A53%3A04Z&sr=c&sp=r&sig=JADJOWZrfi4QEJLFVwu76bI4k%2B%2F3Oapdia%2BqbKIdiKQ%3D)

With your file downloaded, you're ready to use it in the import process to promote it to your Production environment level.

## Importing Assets

After accessing the Integration Gateway, you'll use the **Promote** tab to import a recipe package to a production environment level. After navigating to this section of the Integration Gateway, click the **Import** tab. From this tab, you can create an import manifest to store the assets you exported and downloaded from your non-production environment level.

[![A static image displaying the selection of the Promote and Import tabs in the Integrations Gateway.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway_Import_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A53%3A04Z&se=2026-11-09T04%3A53%3A04Z&sr=c&sp=r&sig=JADJOWZrfi4QEJLFVwu76bI4k%2B%2F3Oapdia%2BqbKIdiKQ%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway%20Import.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A53%3A04Z&se=2026-11-09T04%3A53%3A04Z&sr=c&sp=r&sig=JADJOWZrfi4QEJLFVwu76bI4k%2B%2F3Oapdia%2BqbKIdiKQ%3D)

### Creating an Import Manifest

Before you import your non-production assets, you must create an import manifest to store them.

To create an import manifest:

1. Navigate to the **Promote** tab.
2. Click **Import**.
3. Click **Import Package to a New Folder**.
4. In the **Select ZIP File*** field, browse for or drag and drop your non-production asset file.

> [!WARNING]
> This field only supports ZIP files.
5. From the **Target Folder*** drop-down, select the project folder and subfolders where you want to store the manifest.

[![A static image displaying the uploaded asset file and the project folder where it will be stored.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway_Upload_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A53%3A04Z&se=2026-11-09T04%3A53%3A04Z&sr=c&sp=r&sig=JADJOWZrfi4QEJLFVwu76bI4k%2B%2F3Oapdia%2BqbKIdiKQ%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway%20Upload.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A53%3A04Z&se=2026-11-09T04%3A53%3A04Z&sr=c&sp=r&sig=JADJOWZrfi4QEJLFVwu76bI4k%2B%2F3Oapdia%2BqbKIdiKQ%3D)
6. Click **Next**.
7. Review your assets to ensure you have the correct file.
8. Click **Next**. You assets import into the Integration Gateway.
9. After the import is complete, click **Finish**.

Your imported file now displays in the project folder of your production environment level and are ready for use. Inside your project folder, import other assets by clicking **Import a New Package to This Folder**.

[![A static image displaying the imported file in your production environment level's project folder.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway_Import_Prod_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A53%3A04Z&se=2026-11-09T04%3A53%3A04Z&sr=c&sp=r&sig=JADJOWZrfi4QEJLFVwu76bI4k%2B%2F3Oapdia%2BqbKIdiKQ%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway%20Import%20Prod.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A53%3A04Z&se=2026-11-09T04%3A53%3A04Z&sr=c&sp=r&sig=JADJOWZrfi4QEJLFVwu76bI4k%2B%2F3Oapdia%2BqbKIdiKQ%3D)

## Resources

- [Integration Administration](/v1/docs/adm-intro-integration-administration).
- [How to: Create Connections and Recipes Using the Integration Gateway](/v1/docs/how-to-create-connections-and-recipes-using-the-integration-gateway).
- [How to: Create On-Prem Agents Using the Integration Gateway](/v1/docs/how-to-create-on-prem-agents-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).

Also known as Unqork Users, or Designer Users; is anyone who is inside the Unqork platform.