# Add New Flow

To add a new Flow, click on the **Add New** button. <br>

![](/files/-MFAwY9qUSlI0qbA8eov)

The Add Flow page contains three sections:&#x20;

## Flow Setup

Enter the following details to get started with a Flow:

* A suitable Flow Name&#x20;
* A brief description of the Flow&#x20;
* Status toggle On/Off button: To enable or disable the Flow
* Systems:  Displays systems that are configured in the Flow API

#### Add Source Response

Source API fields to display in the Mapping node.&#x20;

For dynamic calls, the user makes a POST call to the DCKAP Integrator API and provides data. When DCKAP Integrator processes this request, the Flow is unaware of the input format since there is no API to get the information. The source data will be provided to the keyword `PAYLOAD` by default and which can be used in Flows further.

To show the fields in the mapping, the user has to provide both source and destination API. However, the user doesn't have a source API, since it is directly provided in `PAYLOAD`. So the user has to provide the source response, which contains the sample template of data that the user is sending (similar to API Manager - Request) and the user has to choose the `SOURCE RESPONSE` option in the source API of mapping node.

![Mapping Handler Configuration](/files/-MFAv0qQOnQ2HUzNqX0i)

#### Import Flows

Choose a JSON file to import the flow. Only exported JSON Flow files can be imported here. This is used to transfer flows from one project to another.

#### Export Flows

Export Flows allows users to save the entire Flow as a JSON file.&#x20;

{% hint style="success" %}
Difference between Save and Save & Merge

After making changes to the Flow

* ***Save*** - if you click on Save, changes will be saved but do not reflect in the pipe
* ***Save & Merge*** - Clicking on Save & Merge, will reflect changes made in the pipe
  {% endhint %}

## Flow Builder

Users can drag and drop the Handlers to the Flow Builder. After the Handlers are placed in the Flow Builder, they are configured by adding parameters and assigning variables.

## Flow Configuration

### Handlers&#x20;

As mentioned earlier, Handlers are code-representation statements that carry out specific functionalities. Examples include API Call, If, Loop, Increment Variable, Initialize Variable, etc.&#x20;

[Learn more](/developers/flows.md) about handlers.

### Pipes

This tab will display the Pipes that the Flow is linked to.

### Snippets

Snippets are a small section of the Flow, consisting of a block of statements, that are inserted into the Flow as needed.  These typically include commonly used functions and loops, which can be easily included in a large Flow.

For example, the statements inside an IF loop can be composed as one snippet, which can then be used within a larger Flow.  &#x20;

This makes the Flow more readable and avoids repetitive lines of statements.

Snippets can be imported and exported between Flows.&#x20;

The Number of Snippets used in a flow is displayed as shown in the image below:

![](/files/PqsFkkeyHWDkTxbRCPgJ)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dckapintegrator.com/developers/flows/add-new-flow.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
