# Getting Started

## What is Integry? <a href="#h_01hqnsten2zpbbqw08fwb0psje" id="h_01hqnsten2zpbbqw08fwb0psje"></a>

Integry is an Integration Platform as a Service (iPaaS) that allows you to embed integrations inside your products in minutes.

You can create and embed integration templates called Flows. Your users can browse these Flows inside your app through our the Embedded Marketplace. You build flows between your app and up to 300+ other apps. Your users get a fully native integration experience within your product. Their data moves seamlessly between their apps.

If you're building agents, you can use individual Integry App Actions called Functions. We provide several popular agent framework support.&#x20;

We provide managed authentication for Flows and Functions, including setup UI, credentials lifecycle management and more.

Here are the key concepts that you need to know to use Integry.

## Flow <a href="#h_01hnbfr5vv3pygsg5gddx48qdc" id="h_01hnbfr5vv3pygsg5gddx48qdc"></a>

A **flow** moves data from one app to another. It is comprised of one or more blocks that run and execute steps when triggered. Flows sync data [from another app](/flows/markdown/sync-data-from-another-app-to-your-app.md) to your app, [to another app](/flows/markdown/sync-data-to-another-app-from-your-app.md) from your app, or both. Learn how to [build a flow.](/flows/editor.md) You can also do our [AI Quickstart](https://docs.integry.ai/hc/en-us/articles/28305439384473-AI-Quickstart) as well.

<figure><img src="https://docs.integry.ai/hc/article_attachments/28183793226649" alt=""><figcaption></figcaption></figure>

## Block <a href="#h_01hnbfr93q0v3w0d65rg0mgacj" id="h_01hnbfr93q0v3w0d65rg0mgacj"></a>

A (trigger) **block** is comprised of one trigger and one or more subsequent steps. Each block must have a trigger that will run the block.

<figure><img src="/files/XYdxZM2Q3EldYgaWzTbV" alt=""><figcaption></figcaption></figure>

## Trigger <a href="#h_01hnbh26nyfh3rkp2jd3gwwcnp" id="h_01hnbh26nyfh3rkp2jd3gwwcnp"></a>

A **trigger** is an event, a poll, a webhook, or a scheduler that runs a block of an integration of a flow.

## Step <a href="#h_01hnbh34tmjhr6bt4zt1datn1c" id="h_01hnbh34tmjhr6bt4zt1datn1c"></a>

A run executes one or more **steps** in the flow. A step can be a query, an action, a control step, a condition, or execute custom code. Some steps are considered [tasks](#h_01hnbhz2dst2q97m0pn2en40xj) and are charged.

## Query <a href="#h_01hnbhrzmymy75tjrbm82s9yzg" id="h_01hnbhrzmymy75tjrbm82s9yzg"></a>

A query pulls data from an API endpoint by making one (or more) HTTP call(s). It can be used as a step, or as the source of a dynamic dropdown, custom fields, etc.

## Action <a href="#h_01hnbhs1k1cn1knfzgcx5tqvdj" id="h_01hnbhs1k1cn1knfzgcx5tqvdj"></a>

An action pushes data to an API endpoint by making an HTTP call.

## Setup form <a href="#h_01hnbh34tk0tzxzq6zrwrktvm4" id="h_01hnbh34tk0tzxzq6zrwrktvm4"></a>

The **setup form** of a flow is what a user sees when they are setting up an integration of the flow. It can have one or more pages, and a page can have one or more fields.

<figure><img src="/files/pDtNWMG05ZM75Lcmy5kI" alt=""><figcaption></figcaption></figure>

## Marketplace <a href="#h_01hnbh34tm0bzhbpt0k9p0gnqd" id="h_01hnbh34tm0bzhbpt0k9p0gnqd"></a>

The marketplace is what you [embed in your app](broken://pages/3ocPBOvWARUN7bAf1292) using the SDK so your users can setup integrations. You can control what flows to show by tagging them, and filtering on those tags. The widget emits a number of different [events](/apis-and-sdks/js-sdk-reference/events.md) that you can leverage to control the user journey.

<figure><img src="/files/RukEzLPKFJQkcdeXw9Zx" alt=""><figcaption></figcaption></figure>

## Tag <a href="#h_01hnbk5zapq1tyf4ntsgmz8pss" id="h_01hnbk5zapq1tyf4ntsgmz8pss"></a>

A tag is a piece of text you can use to label flows to selectively show them in the [widget](broken://pages/BK1xCAWa6HEyHcDU8Oxr).

## User <a href="#h_01hnbk5zapk504515xhby98h3s" id="h_01hnbk5zapk504515xhby98h3s"></a>

A user is a user of your app who will setup integrations with other apps using the Integry widget embedded  within your app. [Learn more...](/users-and-billing/how-does-pricing-work.md)

## App <a href="#h_01hnbqkn50yx6g99ss7kk8v4ek" id="h_01hnbqkn50yx6g99ss7kk8v4ek"></a>

An app (or "application") is a web application that you can make HTTP calls to, or receive HTTP calls from, in a flow. It could be your application (referred to as "your app") or a third-party application like Mailchimp (referred to as "another app" or "third-party apps"). All calls from Integry to any app are [authenticated](#h_01hnbqkn504cjnvrj2qb0drkwb).

## Authentication <a href="#h_01hnbqkn504cjnvrj2qb0drkwb" id="h_01hnbqkn504cjnvrj2qb0drkwb"></a>

All HTTP calls made by Integry to any API endpoint are authenticated. If it's a call to *your app*, it will use an API key. If it's a call to *another app*, it will use OAuth 2.0 (if supported -- you can use your own developer app), or another such method.

## Account <a href="#h_01hnbkcnwepqwy0cpan8nxb3gq" id="h_01hnbkcnwepqwy0cpan8nxb3gq"></a>

Before they setup an integration of a flow with an app, users will have to connect to that app to give Integry access to their account in that app. You can allow users to connect and setup integrations with multiple accounts of an app.&#x20;

## Integration <a href="#h_01hnbfrb883b2v83p77esmk0xn" id="h_01hnbfrb883b2v83p77esmk0xn"></a>

An **integration** is an instance of a flow with a third-party app setup by your user using a [account](#h_01hnbkcnwepqwy0cpan8nxb3gq) of that app. You can allow users to setup one or more integrations of a flow.&#x20;

<figure><img src="/files/1j22JmSJ1iiEvj5dWxU1" alt=""><figcaption></figcaption></figure>

## Run <a href="#h_01hnbfrd7hb30hzw0nc853fcxd" id="h_01hnbfrd7hb30hzw0nc853fcxd"></a>

A block of an integration **runs** when it is triggered by an event, on a schedule, or by a user action, and executes one or more steps in the block.

## Task <a href="#h_01hnbhz2dst2q97m0pn2en40xj" id="h_01hnbhz2dst2q97m0pn2en40xj"></a>

A **task** is a step that executes an HTTP call or runs custom code. If such a step is in a loop, a task will be charged every time that step executes in a run.

## Workspace <a href="#h_01hnjq030nre13cev40r2mxt2y" id="h_01hnjq030nre13cev40r2mxt2y"></a>

A workspace is your organization's private space for building and launching flows and managing integrations created by your users. Organizations with an Enterprise account can create multiple workspaces.&#x20;


---

# 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.integry.ai/getting-started/key-concepts.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.