> For the complete documentation index, see [llms.txt](https://docs.recrubo.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.recrubo.app/getting-started/async-requests.md).

# Async requests

{% hint style="warning" %}
You need to be subscribed to the [Webhooks](/getting-started/webhooks.md) to receive updates resources or fields.
{% endhint %}

## Triggering a FlowRun

To trigger a [FlowRun](/resources/api-resource-reference/flowrun.md) a post request to `/flow-runs` with the [MessageThread](/resources/api-resource-reference/messagethread.md) and a [Flow](/resources/api-resource-reference/flow.md) is required. Once created you will receive the created FlowRun with the status `created`. All further updates will be done via [Webhooks](/getting-started/webhooks.md).

Once created we will instantaneously try to start the FlowRun and send you an update of the changed status of the FlowRun to `running` once the status changes again to `finished`, `timeout` or `exception` you will get a new notification.

The `state` attribute will contain data gathered during the flow.

Visualized it looks like this:

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

## Generating a "vacancy\_application\_flow"

Triggering a [FlowGeneration](/resources/api-resource-reference/flowgeneration.md) follows a similar path, in this example we will visualize the creation of a [vacancy\_application\_flow](/resources/flow-types/vacancy_application_flow.md).

As input for the FlowGeneration, you can optionally use the [VacancyAnalysis](/resources/api-resource-reference/vacancyanalysis.md), after that POST to `/flow-generations`. All further updates will be done via [Webhooks](/getting-started/webhooks.md).

<figure><img src="/files/5Bn9HJYrP3nRCQOR7jSz" alt=""><figcaption></figcaption></figure>