---
title: Quick Guide - Creating an Integration
description: See how to create an integration from start to finish
documentId: ipaas-legacy-create-flow
locale: en-US
---

Check out this quick guide and **create an integration flow from start to finish**:

## Create authorizations

<Steps>
  <Step>
   Click on the **Authorizations** card.
  </Step>
  <Step>
   Click on **+ AUTHORIZATIONS**.
  </Step>
  <Step>
   Choose the authorization type.
  </Step>
  <Step>
   Fill in the form.
  </Step>
  <Step>
  Click on **SAVE**.
  </Step>
</Steps>

**Creating an authorization**
![Creating an authorization](https://creative-ball-51b3fc85c0.media.strapiapp.com/authorization_quick_guide_af02ea8c50.gif)

<Callout type="NOTE" title="NOTE">
Learn more about creating and configuring authorizations in [Authorizations](/docs/integrations/ipaas-authorizations).
</Callout>

## Create an integration flow

<Steps>
  <Step>
   Click on the **Integration Flows** card.
  </Step>
  <Step>
    
    Click on **+ NEW FLOW**.
    
    <Callout type="NOTE" title="NOTE">
    The canvas is locked when opened.
    To unlock it, enter a unique **name** and **version** for the integration flow.
    </Callout>
  </Step>
  <Step>
    
   Click on **SAVE**.
  </Step>
</Steps>

![Creating an integration flow](https://creative-ball-51b3fc85c0.media.strapiapp.com/creating_a_flow_0cf0f2c82e.gif)

## Register environment variables

<Steps>
  <Step>
   
    Click on the ![Environment Variables](https://creative-ball-51b3fc85c0.media.strapiapp.com/environment_variables_button_fea45f4f76.png) button, in the editing menu on the left.
  </Step>
  <Step>
    
    Fill in the **Name** and **Description** fields in the **INFORMATION** section.
  </Step>
  <Step>
    
    Click on **+ ADD A NEW VARIABLE**, in the **ROOT** section.
  </Step>
  <Step>
    
    Fill in the registration fields:
    * **Type**: select the variable type.
    * **Variable**: enter the variable name. It is not allowed to register the same variable more than once.
    * **Value**: enter the variable value.
  </Step>
  <Step>
    
    Click on **SAVE**.
  </Step>
</Steps>

![Configuring environment variables](https://creative-ball-51b3fc85c0.media.strapiapp.com/environment_Variables_1591a121d7.gif)

<Callout type="NOTE" title="NOTE">
Learn more about creating and configuring [Environment Variables](/docs/integrations/ipaas-legacy-variables).
</Callout>

## Add and configure steps on the canvas

By default, you will see the ![Start](https://creative-ball-51b3fc85c0.media.strapiapp.com/flow_Start_Icon_5e71220cc1.png) **Start** and ![End](https://creative-ball-51b3fc85c0.media.strapiapp.com/flow_End_Icon_0e57333656.png) **End** steps on the canvas.
They mark the beginning and end of the integration flow, in that order.

### Triggers

To start the integration flow, add a *trigger* type step. 

<Steps>
  <Step>
    
    Click on the ![Triggers](https://creative-ball-51b3fc85c0.media.strapiapp.com/triggers_Icon_b3edc4ff83.png) icon, in the editing menu on the left.
  </Step>
  <Step>
    
    Select a *trigger*.
    
    The ![Start](https://creative-ball-51b3fc85c0.media.strapiapp.com/flow_Start_Icon_5e71220cc1.png) **Start** is replaced by the *trigger* as soon as you add it to the canvas.
  </Step>
  <Step>
   
    Fill in the form.
  </Step>
  <Step>
    
    Click on **SAVE**.
    
    <Callout type="NOTE" title="NOTE">
    The *trigger* allows only one connection to the subsequent step.
    </Callout>
  </Step>
</Steps>

![Configuring a Scheduler Trigger](https://creative-ball-51b3fc85c0.media.strapiapp.com/scheduler_Trigger_3a856466e2.gif)

<Callout type="NOTE" title="NOTE">
Learn more about configuring [Triggers](/docs/integrations/ipaas-legacy-triggers).
</Callout>

### Connectors

Next, add *connector* type steps to the integration flow. 

<Steps>
  <Step>
    
    Click on the ![Connectors](https://creative-ball-51b3fc85c0.media.strapiapp.com/connectors_Icon_1f4432d891.png) icon, in the editing menu on the left.
  </Step>
  <Step>
   
    Select a *connector*.
    
    <Callout type="NOTE" title="NOTE">
    Each *connector* allows only one connection to the previous step and one connection to the subsequent step.
    </Callout>
  </Step>
  <Step>
    
    Configure the *connector*.
  </Step>
  <Step>
   
    Click on **SAVE**.
    
    <Callout type="TIP" title="TIP">
    After configuring and connecting the *steps*, the ![Alert](https://creative-ball-51b3fc85c0.media.strapiapp.com/alert_Icon_86fad7682f.png) icon will disappear.
    </Callout>
  </Step>
</Steps>

![Configuring a connector](https://creative-ball-51b3fc85c0.media.strapiapp.com/connector_quick_guide_6410526aa4.gif)

<Callout type="NOTE" title="NOTE">
Learn more about configuring [Connectors](/docs/integrations/ipaas-legacy-connectors).
</Callout>

### General Tools

The *General Tools* perform operations with data within the integration flow.

<Callout type="TIP" title="TIP">
This *step* is not mandatory.
</Callout>

<Steps>
  <Step>
    
    Click on the ![General Tools](https://creative-ball-51b3fc85c0.media.strapiapp.com/general_Tools_Icon_43cb976f10.png) icon, in the editing menu on the left.
  </Step>
  <Step>
    
    Select a tool.
  </Step>
  <Step>
   
    Fill in the form.
  </Step>
  <Step>
    
    Click on **SAVE**.
  </Step>
</Steps>


![Configuring the For Each tool](https://creative-ball-51b3fc85c0.media.strapiapp.com/for_each_quick_guide_5d9ffc7003.gif)

<Callout type="NOTE" title="NOTE">
Learn more about the different [General Tools](/docs/integrations/ipaas-legacy-general-tools) and their configurations.
</Callout>

## Save the integration flow and run it in Test Mode

After saving your flow, run a test to check for any errors before deploying. 

<Steps>
  <Step>
    
    Click on the **TEST MODE** button, in the upper right corner of the canvas.
  </Step>
  <Step>
    
    If you used the *Rest Trigger* in your flow, define the execution payload in the **Body** field and enter the values for **Headers** and **Query Params**.
  </Step>
  <Step>
    
    Click on the **EXECUTE** button to run your integration flow.
  </Step>
  <Step>
   
    Check the execution information in the **Execution Info** section.
  </Step>
  <Step>
    
    Click on ![View Log](https://creative-ball-51b3fc85c0.media.strapiapp.com/open_in_new_Icon_4201b7f235.png) **View Log** to check the detailed execution logs.
  </Step>
</Steps>


![Testing your integration flow](https://creative-ball-51b3fc85c0.media.strapiapp.com/test_mode_quick_guide_711476f9ee.gif)

<Callout type="NOTE" title="NOTE">
Learn more about the integration flow [Test Mode](/docs/integrations/ipaas-legacy-test-mode).
</Callout>

## Deploy the integration flow

<Steps>
  <Step>
    
    Click on the **DEPLOY** button in the upper right corner of the canvas.
  </Step>
  <Step>
    
    Fill in the fields:
    
    * **Description** *(optional)*: the deployment description. 
    * **Environment**: selection field to choose the deployment environment. You must choose between:
      * *Staging*: testing environment. It is enabled by default.
      * *Production*: production environment.
    * **Value** *(optional)*: the value of the environment variable registered in the flow. Editable field.
    
    <Callout type="NOTE" title="NOTE">
    The other fields are read-only.
    </Callout>
  </Step>
  <Step>
    
    Click on **DEPLOY** in the lower right corner to deploy your flow.
  </Step>
</Steps>

![Deploying your integration flow](https://creative-ball-51b3fc85c0.media.strapiapp.com/deploy_quick_guide_e7f6a52d9e.gif)

<Callout type="NOTE" title="NOTE">
Learn more about the integration flow [Deploy](/docs/integrations/ipaas-legacy-deploy).
</Callout>